enterprise.networkingAttributes

The enterprise.networkingAttributes permission allows an extension, running on a managed device, to read networking attributes of the device.

This is an enterprise-only and ChromeOS-only permission. It can only be used by extensions that are force-installed by enterprise policy on a managed ChromeOS device.

What it does

  • Grants access to the chrome.enterprise.networkingAttributes API.
  • Exposes a single method, getNetworkDetails(), which returns the device's current MAC address, IPv4 address, and IPv6 address for the active network.

When to use it

This is for extensions in a corporate environment that need networking information for identification, troubleshooting, or reporting.

Examples:

  • A support tool that displays network information to a helpdesk agent.
  • An extension that communicates with other devices on the local network and needs the device's IP address.
  • A security extension that logs network identifiers for auditing purposes.

Manifest Declaration

{
  "name": "My Enterprise Network Reporter",
  "version": "1.0",
  "manifest_version": 3,
  "permissions": [
    "enterprise.networkingAttributes"
  ]
}

Security & Privacy

Why is it not risky for you?

This is a special permission that only works on computers managed by a company or school IT department. It is designed for corporate environments and will have no effect on your personal computer.

If you see an extension asking for this permission for your personal use, it's likely a mistake or a poorly designed extension, but it does not pose a direct security threat to you because the permission will not function outside of a managed enterprise setting. On a work computer, this permission is used by your IT department to manage device and network settings for administrative and security purposes.

API Usage Example

This example reads the device's MAC address and IP address.

// background.js or popup.js

async function getNetworkAttributes() {
  if (!chrome.enterprise || !chrome.enterprise.networkingAttributes) {
    console.log('This API is only available on managed ChromeOS devices.');
    return;
  }
  try {
    const details = await chrome.enterprise.networkingAttributes.getNetworkDetails();
    console.log('MAC Address:', details.macAddress);
    console.log('IPv4 Address:', details.ipv4);
    console.log('IPv6 Address:', details.ipv6);
  } catch (error) {
    console.error('Error retrieving network attributes:', error);
  }
}

getNetworkAttributes();

Extensions with the enterprise.networkingAttributes permission

Here are some popular browser extensions that use the "enterprise.networkingAttributes" permission. To explore more, try our Advanced search.

Firefox Firefox add-ons with "enterprise.networkingAttributes" permission

Permission Metrics

Popularity

Security Risk


Usage by Platform