Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://cloud.google.com/access-context-manager/docs/custom-access-level-spec below:

Custom access level specification | Access Context Manager

Stay organized with collections Save and categorize content based on your preferences.

This page details the objects and attributes that are used to the build the Common Expression Language (CEL) expressions for custom access levels. Examples are included.

To learn more about CEL, see the CEL language definition.

Access Context Manager provides four objects that contain access level attributes.

This section lists the attributes supported by the origin object.

The IP address the request originated from. If the IP address cannot be determined, origin.ip evaluates to an error. We recommend that you use inIpRange to check if the origin IP address is in a specific IP address range instead of doing a string comparison.

Example:

inIpRange(origin.ip, ["203.0.113.24"])

The ISO 3166-1 alpha-2 code for the country or region where the request originated from. If the region code cannot be determined, origin.region_code evaluates to an error.

Example:

origin.region_code == "GB"
origin.region_code in ["US", "FR", "JP"]

This section lists the attributes supported by the request.auth object.

The unique ID of the user who issued the request.

The value for request.auth.principal must be one or more unique user IDs. The UUIDs can be obtained using the Admin SDK Directory API.

The value must be in the following format: https://accounts.google.com/UUID

Where UUID is the UUID of a user.

Example:

request.auth.principal == "https://accounts.google.com/1134924314572461055"
request.auth.principal in ["https://accounts.google.com/1134924314572461055", "https://accounts.google.com/3134824314572461115"]

User authenticated with a password.

Example:

request.auth.claims.crd_str.pwd == true

User authenticated with a push notification to the mobile device.

Example:

request.auth.claims.crd_str.push == true

User authenticated using a code sent to SMS or via a phone call.

Example:

request.auth.claims.crd_str.sms == true

2SV used a software key, such as a phone, as security key.

Example:

request.auth.claims.crd_str.swk == true

2SV used a hardware key, such as Google Titan Key.

Example:

request.auth.claims.crd_str.hwk == true

User authenticated with one time password methods (Google Authenticator and Backup Codes).

Example:

request.auth.claims.crd_str.otp == true

User authenticated with any of the methods in this table except pwd.

Example:

request.auth.claims.crd_str.mfa == true

For more information about credential strength policy, see Configuring a credential strength policy.

This section lists the attributes supported by the levels object.

level name corresponds to the name of an existing access level.

When used, the conditions of the specified access level must also be met in addition to the other requirements of your custom access level.

Example:

levels.allow_corp_ips

Where allow_corp_ips is the name of an access level.

This section lists the attributes supported by the device object. If no device associated to the identifiers in the request is found, all of the following attributes will evaluate to an error.

Describes the encryption status of the device.

Enum values:

enum DeviceEncryptionStatus {
  // The encryption status of the device is not specified or not known.
  ENCRYPTION_UNSPECIFIED == 0;
  // The device does not support encryption.
  ENCRYPTION_UNSUPPORTED == 1;
  // The device supports encryption, but is currently unencrypted.
  UNENCRYPTED == 2;
  // The device is encrypted.
  ENCRYPTED == 3;
}

Example:

device.encryption_status == DeviceEncryptionStatus.ENCRYPTED

Whether the device has been approved by the domain administrator.

Example:

device.is_admin_approved_device == true

Whether the device is owned by the organization.

Example:

device.is_corp_owned_device == true

Whether the device has its screen lock function enabled.

Example:

device.is_secured_with_screenlock == true

Identifies which operating system the device is using.

Enum values:

enum OsType {
  // The operating system of the device is not specified or not known.
  OS_UNSPECIFIED == 0;
  // A desktop Mac operating system.
  DESKTOP_MAC == 1;
  // A desktop Windows operating system.
  DESKTOP_WINDOWS == 2;
  // A desktop Linux operating system.
  DESKTOP_LINUX == 3;
  // An Android operating system.
  ANDROID == 4;
  // An iOS operating system.
  IOS == 5;
  // A desktop ChromeOS operating system.
  DESKTOP_CHROME_OS == 6;
}

Example:

device.os_type == OsType.DESKTOP_MAC
device.os_type != OsType.OS_UNSPECIFIED

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

The vendors object is used to access data provided by third-party security and endpoint management vendors. Each vendor may populate three shared top-level attributes: is_compliant_device, is_managed_device, and device_health_score.

Additionally, vendors may provide their own keys and values that are referenced using the data attribute. The available keys for the data attribute vary from vendor to vendor. Ensure that you are consistent when comparing the key value in your policy expression. For example, if you expect the key value to be a string or boolean, ensure that you compare it with a string or boolean in the policy expression correspondingly. Note that when the value is an integer, you should compare it with a double number in the policy expression.

To reference device state, use the format key-acme where acme is the organization's customer ID. You can get the customer ID from the GET https://www.googleapis.com/admin/directory/v1/customers/my_customer URL. The ID field in the response contains the customer ID starting with the letter C. Use the string after the letter C, excluding the letter C, for the customer ID.

Enum values:

// Health score of the device as provided by the vendor (possibly third party).
enum DeviceHealthScore {
  // The health score for the device is not specified or unknown.
  DEVICE_HEALTH_SCORE_UNSPECIFIED = 0;
  // The health of the device is very poor.
  VERY_POOR = 1;
  // The health of the device is poor.
  POOR = 2;
  // The health of the device is ok.
  NEUTRAL = 3;
  // The health of the device is good.
  GOOD = 4;
  // The health of the device is very good.
  VERY_GOOD = 5;
}

Examples:

device.vendors["some_vendor"].is_compliant_device == true

device.vendors["some_vendor"].is_managed_device == true

device.vendors["some_vendor"].device_health_score == DeviceHealthScore.VERY_GOOD

device.vendors["some_vendor"].data["is_device_compromised"] == true

device.vendors["some_vendor"].data["some_num"] == 1.0

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Whether the Android verified boot status is green.

Example:

device.android_device_security.verified_boot == true

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Whether device passes CTS profile compliance.

Example:

device.android_device_security.cts_profile_match == true

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Whether the device has Google Play Protect Verify Apps enabled.

Example:

device.android_device_security.verify_apps_enabled == true

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Whether potentially harmful apps were found on the device.

Example:

device.android_device_security.has_potentially_harmful_apps == true

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Whether the iOS device was found to be jailbroken.

Example:

device.ios_device_security.is_device_jailbroken == true

Whether the request comes from a device with a verified Chrome OS.

Example:

device.verified_chrome_os == true

Is the browser managed, at the browser level or at the profile level, and by the enterprise under the correct domain.

A browser is considered to be managed if the policies are centrally managed and pushed, and that the domain of the managed browser or profile matches the expected domain on the server side.

Following are the available Chrome management states:

Example:

device.chrome.management_state in
    [
        ChromeManagementState.CHROME_MANAGEMENT_STATE_BROWSER_MANAGED,
        ChromeManagementState.CHROME_MANAGEMENT_STATE_PROFILE_MANAGED,
    ]

Is the browser above a certain minimum version.

Example:

device.chrome.versionAtLeast("88.0.4321.44")

Is the real-time URL check connector enabled.

Example:

device.chrome.is_realtime_url_check_enabled == true | false

Is the file upload analysis connector enabled.

Example:

device.chrome.is_file_upload_analysis_enabled == true | false

Is the file download analysis connector enabled.

Example:

device.chrome.is_file_download_analysis_enabled == true | false

Is the bulk text (paste) analysis connector enabled.

Example:

device.chrome.is_bulk_data_entry_analysis_enabled == true | false

Is the security event reporting connector enabled.

Example:

device.chrome.is_security_event_analysis_enabled == true | false

Access Context Manager provides the following functions for use in the CEL expressions for custom access levels.

Checks whether an IP address belongs to one of the given subnets.

Example:

inIpRange(origin.ip, ["192.0.2.0/24", "198.51.100.0/24", "203.0.113.0/24"])

Checks whether the device operating system is at least a given version. We recommend that you use this function with the device.os_type attribute.

Example:

device.versionAtLeast("10.0") == true

Checks if the client certificate associated with the origin matches the device and reports the state.

The state returned by the function can be one of the following:

• CertificateBindingState.CERT_MATCHES_EXISTING_DEVICE
• CertificateBindingState.CERT_NOT_MATCHING_EXISTING_DEVICE
• CertificateBindingState.CERT_STATE_UNKNOWN

Example:

certificateBindingState(origin, device) == CertificateBindingState.CERT_MATCHES_EXISTING_DEVICE

Tests whether the string operand starts with the prefix argument.

Example:

"Sample string".startsWith("Sample")

Tests whether the string operand ends with the suffix argument.

Example:

"Sample string".endsWith("string")

Returns the fingerprint of the certificate associated with the origin. You can use this in macros to test device certificates.

Example:

// Checks if the enterprise certificate associated with the origin matches the device.
device.certificates.exists(cert, cert.is_valid && cert.cert_fingerprint == origin.clientCertFingerprint())

You can use the following macros in the CEL expressions for custom access levels:

has({"key": "value"}.key) has(device.vendors.some_vendor)

This returns false because not all elements are greater than 1:
[1,2,3].all(x, x > 1)

This returns true because there is at least one element in the list greater than 1:
[1,2,3].exists(x, x > 1)

Checks if the enterprise certificate associated with the device matches the issuer:
device.certificates.exists(cert, cert.is_valid && cert.issuer == "EMAILADDRESS=test_inter1@beyondcorp.in, CN=inter_1, OU=BCEDemo_1, O=BCEDemo, L=NCR, ST=UP, C=IN")

This returns false because more than one element is greater than 1:
[1,2,3].exists_one(x, x > 1)

This section includes examples of CEL expressions used to create custom access levels.

device.encryption_status == DeviceEncryptionStatus.ENCRYPTED && (origin.region_code in ["US"] || device.is_admin_approved_device)

This example represents an access level that requires the following conditions be met in order to allow a request:

• The device that the request originated from is encrypted.

• One or more of the following is true:

  • The request originated in the United States.

  • The device that the request originated from is approved by the domain administrator.

(device.os_type == OsType.DESKTOP_WINDOWS && device.is_corp_owned_device) || (device.os_type == OsType.DESKTOP_MAC && device.is_admin_approved_device && device.versionAtLeast("10.11.0"))

This example represents an access level that requires the following conditions be met in order to allow a request:

• One of the following is true:

  • The device that the request originated from uses a desktop Windows operating system and is owned by your organization.

  • The device that the request originated from uses a desktop Mac operating system, is approved by the domain administrator, and is using at least MacOS 10.11.

(certificateBindingState(origin, device) == CertificateBindingState.CERT_MATCHES_EXISTING_DEVICE)

This example represents an access level that requires the following condition be met in order to allow a request:

• The certificateBindingState extension function determines that the certificate presented at request time matches one of the device certificates that was registered when the device was enrolled in endpoint verification.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-08-07 UTC.

[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["This document outlines four primary objects—`origin`, `request.auth`, `levels`, and `device`—used to construct Common Expression Language (CEL) expressions for Access Context Manager, each containing specific attributes to evaluate access levels."],["The `origin` object offers attributes like `ip` and `region_code` to define the request's source, allowing checks like whether a user is within a specific IP range or region, and supports the use of `inIpRange` to compare ip addresses."],["The `request.auth` object verifies user authentication, identifying the user's ID (`principal`) and the method used for authentication, such as password, push notification, or security key, via `claims.crd_str` attributes."],["The `device` object provides detailed information about the requesting device, including its encryption status, admin approval, ownership, OS type, and device-specific attributes for third-party vendor data, and the use of security protocols."],["The document also includes function and macro details for defining CEL expressions, such as `inIpRange`, `device.versionAtLeast`, `certificateBindingState`, `has`, and `e.all` , `e.exists` and `e.exists_one` for constructing complex access control rules."]]],[]]

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4