diff --git a/docs/ninjaone/automations/browser-homepage-manage.md b/docs/ninjaone/automations/browser-homepage-manage.md new file mode 100644 index 000000000..7faf0fe51 --- /dev/null +++ b/docs/ninjaone/automations/browser-homepage-manage.md @@ -0,0 +1,65 @@ +--- +id: '13d8ac16-33d9-4bf4-b7cb-d8db932c8da6' +slug: /13d8ac16-33d9-4bf4-b7cb-d8db932c8da6 +title: 'Browser - Homepage - Manage' +title_meta: 'Browser - Homepage - Manage' +keywords: ['homepage', 'browsers', 'configuration', 'set', 'remove', 'replace'] +description: 'Custom Field to force the homepage to be the only open tab at the startup of the browser.' +tags: ['chrome', 'edge', 'firefox', 'setup'] +draft: false +unlisted: false +last_update: + date: 2026-10-01 +--- + +## Overview + +Manages browser homepage settings for Chrome, Edge, Brave, and Firefox using signed agnostic scripts. + +## Sample Run + +![Image1](../../../static/img/docs/13d8ac16-33d9-4bf4-b7cb-d8db932c8da6/image1.webp) + +## Dependencies + +- [Custom Field - cPVAL Browser HomePage Action](/docs/9073ddaa-e5c0-478f-a893-e6b8c423fb3d) +- [Custom Field - cPVAL Browser](/docs/117579a5-d7bf-43d5-97e1-ea77163cf7a2) +- [Custom Field - cPVAL Browser Homepage](/docs/bec7d778-7266-46f4-893b-616c0cea5557) +- [Custom Field - cPVAL Browser EnforceOnNewTab](/docs/9e50a4bc-f862-48af-a964-b073cb9cce01) +- [Custom Field - cPVAL Browser EnforceHomepageStartup](/docs/734b02cf-e27d-4bc9-93b6-8054946780f5) +- [Solution - Browser - HomePage - Manage](/docs/3197b1ea-9250-4373-9d21-6124a0b72ec6) + +## Parameters + +| Name | Example | Accepted Values | Required | Default | Type | Description | +| ---- | ------- | --------------- | -------- | ------- | ---- | ----------- | +| Action | `Set` | `Set`, `Replace`, `Remove` | `False` | - | DropDown | Specify desired action to be performed on Browsers Homepage. | +| Browser | `chrome,edge` | `Chrome`, `Edge`, `Firefox`, `Brave` | `False` | - | Text/String | Specify the browser for setting/removing the homepage. Only 'Chrome', 'Edge', 'Brave' and 'Firefox' are acceptable values. Each value should be separated by a comma without any additional spaces, e.g., chrome,firefox. | +| HomePage | `https://www.provaltech.com` | - | `False` | - | Text/String | The string value of the homepage to set in the browser. Useful only with the `Set` and `Replace` | +| EnforceOnNewTab | - | - | `False` | - | Checkbox | Select it to enforce the homepage on each new tab instead of the new tab page. Useful only with the `Set` and `Replace` and only works on Chromium Browsers (Brave,Chrome and Edge). | +| EnforceHomepageStartup | - | - | `False` | - | Checkbox | Select it to enforce the homepage to be the only open tab at the startup of the browser. Useful only with the `Set` and `Replace` | + +## Custom Fields + +| Field Name | Type | Mandatory | Scope | Description | +| ---------- | ---- | --------- | ----- | ----------- | +| [cPVAL Browser HomePage Action](/docs/9073ddaa-e5c0-478f-a893-e6b8c423fb3d) | DropDown | False | `Organization`, `Location`, `Device` | Select the desired action to be performed on Browsers Homepage. Set -> To set the Homepage; Remove -> To remove the Homepage; Replace -> To replace the current Homepage. | +| [cPVAL Browser](/docs/117579a5-d7bf-43d5-97e1-ea77163cf7a2) | Text | False | `Organization`, `Location`, `Device` | Specify the browser for setting/removing the homepage. Only 'Chrome', 'Edge', 'Brave' and 'Firefox' are acceptable values. Each value should be separated by a comma without any additional spaces, e.g., chrome,firefox. | +| [cPVAL Browser Homepage](/docs/bec7d778-7266-46f4-893b-616c0cea5557) | Text | False | `Organization`, `Location`, `Device` | The string value of the homepage to set in the browser. Useful only with the `Set` and `Replace`. | +| [cPVAL Browser EnforceOnNewTab](/docs/9e50a4bc-f862-48af-a964-b073cb9cce01) | Checkbox | False | `Organization`, `Location`, `Device` | Select it to enforce the homepage on each new tab instead of the new tab page. Useful only with the `Set` and `Replace` and only works on Chromium Browsers (Brave,Chrome and Edge). | +| [cPVAL Browser EnforceHomepageStartup](/docs/734b02cf-e27d-4bc9-93b6-8054946780f5) | Checkbox | False | `Organization`, `Location`, `Device` | Select it to force the homepage to be the only open tab at the startup of the browser. Useful only with the `Set` and `Replace`. | + + +## Automation Setup/Import + +[Automation Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/scripts/browser-homepage-manage.ps1) + +## Output + +- Activity Details + +## Changelog + +### 2026-10-01 + +- Initial version of the document \ No newline at end of file diff --git a/docs/ninjaone/compound-conditions/manage-browser-homepage-servers.md b/docs/ninjaone/compound-conditions/manage-browser-homepage-servers.md new file mode 100644 index 000000000..cea44ff5c --- /dev/null +++ b/docs/ninjaone/compound-conditions/manage-browser-homepage-servers.md @@ -0,0 +1,39 @@ +--- +id: '3557a5e1-91f2-4a2b-983c-bf79332ee3ec' +slug: /3557a5e1-91f2-4a2b-983c-bf79332ee3ec +title: 'Manage Browser Homepage - Servers' +title_meta: 'Manage Browser Homepage - Servers' +keywords: ['homepage', 'browsers', 'configuration', 'set', 'remove', 'replace'] +description: 'Triggers the `Browser - Homepage - Manage` automation on Windows servers where deployment is enabled for windows servers from `cPVAL Enable Browser Manage` custom field.' +tags: ['chrome', 'edge', 'firefox', 'setup'] +draft: false +unlisted: false +last_update: + date: 2026-10-01 +--- + +## Summary + +Triggers the [Automation - Browser - Homepage - Manage](/docs/13d8ac16-33d9-4bf4-b7cb-d8db932c8da6) on Windows servers where deployment is enabled for windows servers from [Custom Field - cPVAL Enable Browser Manage](/docs/d63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750). + +## Details + +- **Name:** `Manage Browser Homepage - Servers` +- **Description:** `Triggers the 'Browser - Homepage - Manage' automation on Windows servers where deployment is enabled for windows servers from 'cPVAL Enable Browser Manage' custom field.` +- **Recommended Agent Policy:** `Windows Servers [Default]` + +## Dependencies + +- [Automation - Browser - Homepage - Manage](/docs/13d8ac16-33d9-4bf4-b7cb-d8db932c8da6) +- [Custom Field - cPVAL Enable Browser Manage](/docs/d63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750) +- [Solution - Browser - HomePage - Manage](/docs/3197b1ea-9250-4373-9d21-6124a0b72ec6) + +## Compound Condition Creation + +- [Compound Condition Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/compound-conditions/manage-browser-homepage-servers.toml) + +## Changelog + +### 2026-10-01 + +- Initial version of the document diff --git a/docs/ninjaone/compound-conditions/manage-browser-homepage-workstations.md b/docs/ninjaone/compound-conditions/manage-browser-homepage-workstations.md new file mode 100644 index 000000000..652402c8e --- /dev/null +++ b/docs/ninjaone/compound-conditions/manage-browser-homepage-workstations.md @@ -0,0 +1,39 @@ +--- +id: '0f23c8a1-f507-4c1d-9d3f-8e1233653c1e' +slug: /0f23c8a1-f507-4c1d-9d3f-8e1233653c1e +title: 'Manage Browser Homepage - Workstations' +title_meta: 'Manage Browser Homepage - Workstations' +keywords: ['homepage', 'browsers', 'configuration', 'set', 'remove', 'replace'] +description: 'Triggers the `Browser - Homepage - Manage` automation on Windows Workstations where deployment is enabled for windows workstations from `cPVAL Enable Browser Manage` custom field.' +tags: ['chrome', 'edge', 'firefox', 'setup'] +draft: false +unlisted: false +last_update: + date: 2026-10-01 +--- + +## Summary + +Triggers the [Automation - Browser - Homepage - Manage](/docs/13d8ac16-33d9-4bf4-b7cb-d8db932c8da6) on Windows Workstations where deployment is enabled for windows workstations from [Custom Field - cPVAL Enable Browser Manage](/docs/d63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750). + +## Details + +- **Name:** `Manage Browser Homepage - Workstations` +- **Description:** `Triggers the 'Browser - Homepage - Manage' automation on Windows Workstations where deployment is enabled for windows workstations from 'cPVAL Enable Browser Manage' custom field.` +- **Recommended Agent Policy:** `Windows Workstation [Default]` + +## Dependencies + +- [Automation - Browser - Homepage - Manage](/docs/13d8ac16-33d9-4bf4-b7cb-d8db932c8da6) +- [Custom Field - cPVAL Enable Browser Manage](/docs/d63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750) +- [Solution - Browser - HomePage - Manage](/docs/3197b1ea-9250-4373-9d21-6124a0b72ec6) + +## Compound Condition Creation + +- [Compound Condition Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/compound-conditions/manage-browser-homepage-workstations.toml) + +## Changelog + +### 2026-10-01 + +- Initial version of the document diff --git a/docs/ninjaone/custom-fields/cpval-browser-enforcehomepagestartup.md b/docs/ninjaone/custom-fields/cpval-browser-enforcehomepagestartup.md new file mode 100644 index 000000000..a590b4d63 --- /dev/null +++ b/docs/ninjaone/custom-fields/cpval-browser-enforcehomepagestartup.md @@ -0,0 +1,40 @@ +--- +id: '734b02cf-e27d-4bc9-93b6-8054946780f5' +slug: /734b02cf-e27d-4bc9-93b6-8054946780f5 +title: 'cPVAL Browser EnforceHomepageStartup' +title_meta: 'cPVAL Browser EnforceHomepageStartup' +keywords: ['homepage', 'browsers', 'configuration', 'set', 'remove', 'replace'] +description: 'Custom Field to force the homepage to be the only open tab at the startup of the browser.' +tags: ['chrome', 'edge', 'firefox', 'setup'] +draft: false +unlisted: false +last_update: + date: 2026-09-28 +--- + +## Summary + +Custom Field to force the homepage to be the only open tab at the startup of the browser. Useful only with the `Set` and `Replace` actions. +## Details + +| Label | Field Name | Definition Scope | Type | Required | Default Value | Technician Permission | Automation Permission | API Permission | Description | Tool Tip | Footer Text | Custom Field Tab Name | +| ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | +| cPVAL Browser EnforceHomepageStartup | cpvalBrowserEnforcehomepagestartup | `Organization`, `Location`, `Device` | CheckBox | False | | Read Only | Read/Write | Read/Write | Select it to force the homepage to be the only open tab at the startup of the browser. Only useful with the Set and Replace actions. | Select it to force the homepage to be the only open tab at the startup of the browser. Only useful with the Set and Replace actions. | Select it to force the homepage to be the only open tab at the startup of the browser. Only useful with the Set and Replace actions. | Manage Browser HomePage | + +## Dependencies + +- [Solution - Browser - HomePage - Manage](/docs/3197b1ea-9250-4373-9d21-6124a0b72ec6) + +## Custom Field Creation + +- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-browser-enforcehomepagestartup.toml) + +## Sample Screenshot + +![Image1](../../../static/img/docs/734b02cf-e27d-4bc9-93b6-8054946780f5/image1.webp) + +## Changelog + +### 2026-09-28 + +- Initial version of the document diff --git a/docs/ninjaone/custom-fields/cpval-browser-enforceonnewtab.md b/docs/ninjaone/custom-fields/cpval-browser-enforceonnewtab.md new file mode 100644 index 000000000..4eb802aca --- /dev/null +++ b/docs/ninjaone/custom-fields/cpval-browser-enforceonnewtab.md @@ -0,0 +1,41 @@ +--- +id: '9e50a4bc-f862-48af-a964-b073cb9cce01' +slug: /9e50a4bc-f862-48af-a964-b073cb9cce01 +title: 'cPVAL Browser EnforceOnNewTab' +title_meta: 'cPVAL Browser EnforceOnNewTab' +keywords: ['homepage', 'browsers', 'configuration', 'set', 'remove', 'replace'] +description: 'Custom Field to select it to enforce the homepage on each new tab instead of the new tab page.' +tags: ['chrome', 'edge', 'firefox', 'setup'] +draft: false +unlisted: false +last_update: + date: 2026-10-01 +--- + +## Summary + +Custom Field to enforce the homepage on each new tab instead of the new tab page. Useful only with the `Set` and `Replace` actions and supported exclusively on Chromium Browsers (Brave,Chrome and Edge). + +## Details + +| Label | Field Name | Definition Scope | Type | Required | Default Value | Technician Permission | Automation Permission | API Permission | Custom Field Tab Name | +| ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | +| cPVAL Browser EnforceOnNewTab | cpvalBrowserEnforceonnewtab | `Organization`, `Location`, `Device` | CheckBox | False | | Read Only | Read/Write | Read/Write | Manage Browser HomePage | + +## Dependencies + +- [Solution - Browser - HomePage - Manage](/docs/3197b1ea-9250-4373-9d21-6124a0b72ec6) + +## Custom Field Creation + +- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-browser-enforceonnewtab.toml) + +## Sample Screenshot + +![Image1](../../../static/img/docs/9e50a4bc-f862-48af-a964-b073cb9cce01/image1.webp) + +## Changelog + +### 2026-10-01 + +- Initial version of the document diff --git a/docs/ninjaone/custom-fields/cpval-browser-homepage-action.md b/docs/ninjaone/custom-fields/cpval-browser-homepage-action.md new file mode 100644 index 000000000..bbe9ddcaa --- /dev/null +++ b/docs/ninjaone/custom-fields/cpval-browser-homepage-action.md @@ -0,0 +1,40 @@ +--- +id: '9073ddaa-e5c0-478f-a893-e6b8c423fb3d' +slug: /9073ddaa-e5c0-478f-a893-e6b8c423fb3d +title: 'cPVAL Browser HomePage Action' +title_meta: 'cPVAL Browser HomePage Action' +keywords: ['homepage', 'browsers', 'configuration', 'set', 'remove', 'replace'] +description: 'Custom Field to select the desired action to be performed on Browsers Homepage.' +tags: ['chrome', 'edge', 'firefox', 'setup'] +draft: false +unlisted: false +last_update: + date: 2026-10-01 +--- + +## Summary +Custom Field to select the desired action to be performed on Browsers Homepage. + +## Details + +| Label | Field Name | Definition Scope | Type | Required | Default Value | Options | Technician Permission | Automation Permission | API Permission | Custom Field Tab Name | +| ----- | ---- | ---------------- | ---- | -------- | ------------- | ------------- | --------------------- | --------------------- | -------------- | ----------- | +| cPVAL Browser HomePage Action | cpvalBrowserHomepageAction | `Organization`, `Location`, `Device` | Drop-down | False | | | Editable | Read_Write | Read_Write | Manage Browser HomePage | + +## Dependencies + +- [Solution - Browser - HomePage - Manage](/docs/3197b1ea-9250-4373-9d21-6124a0b72ec6) + +## Custom Field Creation + +- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-browser-homepage-action.toml) + +## Sample Screenshot + +![Image1](../../../static/img/docs/9073ddaa-e5c0-478f-a893-e6b8c423fb3d/image1.webp) + +## Changelog + +### 2026-10-01 + +- Initial version of the document diff --git a/docs/ninjaone/custom-fields/cpval-browser-homepage.md b/docs/ninjaone/custom-fields/cpval-browser-homepage.md new file mode 100644 index 000000000..46ec44d88 --- /dev/null +++ b/docs/ninjaone/custom-fields/cpval-browser-homepage.md @@ -0,0 +1,41 @@ +--- +id: 'bec7d778-7266-46f4-893b-616c0cea5557' +slug: /bec7d778-7266-46f4-893b-616c0cea5557 +title: 'cPVAL Browser Homepage' +title_meta: 'cPVAL Browser Homepage' +keywords: ['homepage', 'browsers', 'configuration', 'set', 'remove', 'replace'] +description: 'Custom Field to add the string value of the homepage to set in the browser.' +tags: ['chrome', 'edge', 'firefox', 'setup'] +draft: false +unlisted: false +last_update: + date: 2026-10-01 +--- + +## Summary + +Custom Field to add the string value of the homepage to set in the browser. Useful only with the `Set` and `Replace` actions. + +## Details + +| Label | Field Name | Definition Scope | Type | Required | Default Value | Technician Permission | Automation Permission | API Permission | Custom Field Tab Name | +| ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | +| cPVAL Browser Homepage | cpvalBrowserHomepage | `Organization`, `Location`, `Device` | Text | False | | Read Only | Read/Write | Read/Write | Manage Browser HomePage | + +## Dependencies + +- [Solution - Browser - HomePage - Manage](/docs/3197b1ea-9250-4373-9d21-6124a0b72ec6) + +## Custom Field Creation + +- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-browser-homepage.toml) + +## Sample Screenshot + +![Image1](../../../static/img/docs/bec7d778-7266-46f4-893b-616c0cea5557/image1.webp) + +## Changelog + +### 2026-10-01 + +- Initial version of the document diff --git a/docs/ninjaone/custom-fields/cpval-browser.md b/docs/ninjaone/custom-fields/cpval-browser.md new file mode 100644 index 000000000..5ebc3ccae --- /dev/null +++ b/docs/ninjaone/custom-fields/cpval-browser.md @@ -0,0 +1,41 @@ +--- +id: '117579a5-d7bf-43d5-97e1-ea77163cf7a2' +slug: /117579a5-d7bf-43d5-97e1-ea77163cf7a2 +title: 'cPVAL Browser' +title_meta: 'cPVAL Browser' +keywords: ['homepage', 'browsers', 'configuration', 'set', 'remove', 'replace'] +description: 'Custom Field to specify the browser for setting/removing the homepage.' +tags: ['chrome', 'edge', 'firefox', 'setup'] +draft: false +unlisted: false +last_update: + date: 2026-10-01 +--- + +## Summary + +Custom Field to specify the browser for setting/removing the homepage. Only 'Chrome', 'Edge', 'Brave' and 'Firefox' are acceptable values. + +## Details + +| Label | Field Name | Definition Scope | Type | Required | Default Value | Technician Permission | Automation Permission | API Permission | Custom Field Tab Name | +| ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | +| cPVAL Browser | cpvalBrowser | `Organization`, `Location`, `Device` | Text | False | | Read Only | Read/Write | Read/Write | Manage Browser HomePage | + +## Dependencies + +- [Solution - Browser - HomePage - Manage](/docs/3197b1ea-9250-4373-9d21-6124a0b72ec6) + +## Custom Field Creation + +- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-browser.toml) + +## Sample Screenshot + +![Image1](../../../static/img/docs/117579a5-d7bf-43d5-97e1-ea77163cf7a2/image1.webp) + +## Changelog + +### 2026-10-01 + +- Initial version of the document diff --git a/docs/ninjaone/custom-fields/cpval-enable-browser-manage.md b/docs/ninjaone/custom-fields/cpval-enable-browser-manage.md new file mode 100644 index 000000000..187af1291 --- /dev/null +++ b/docs/ninjaone/custom-fields/cpval-enable-browser-manage.md @@ -0,0 +1,40 @@ +--- +id: 'd63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750' +slug: /d63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750 +title: 'cPVAL Enable Browser Manage' +title_meta: 'cPVAL Enable Browser Manage' +keywords: ['homepage', 'browsers', 'configuration', 'set', 'remove', 'replace'] +description: 'Custom Field to select the operating system to manage the Browser homepage for the machines.' +tags: ['chrome', 'edge', 'firefox', 'setup'] +draft: false +unlisted: false +last_update: + date: 2026-10-01 +--- + +## Summary +Custom Field to select the operating system to manage the Browser homepage for the machines. + +## Details + +| Label | Field Name | Definition Scope | Type | Required | Default Value | Options | Technician Permission | Automation Permission | API Permission | Custom Field Tab Name | +| ----- | ---- | ---------------- | ---- | -------- | ------------- | ------------- | --------------------- | --------------------- | -------------- | ----------- | +| cPVAL Enable Browser Manage | cpvalEnableBrowserManage | `Organization`, `Location`, `Device` | Drop-down | False | | | Editable | Read_Write | Read_Write | Manage Browser HomePage | + +## Dependencies + +- [Solution - Browser - HomePage - Manage](/docs/3197b1ea-9250-4373-9d21-6124a0b72ec6) + +## Custom Field Creation + +- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-enable-browser-manage.toml) + +## Sample Screenshot + +![Image1](../../../static/img/docs/d63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750/image1.webp) + +## Changelog + +### 2026-10-01 + +- Initial version of the document diff --git a/docs/solutions/browser-homepage-manage.md b/docs/solutions/browser-homepage-manage.md new file mode 100644 index 000000000..107b114db --- /dev/null +++ b/docs/solutions/browser-homepage-manage.md @@ -0,0 +1,201 @@ +--- +id: '3197b1ea-9250-4373-9d21-6124a0b72ec6' +slug: /3197b1ea-9250-4373-9d21-6124a0b72ec6 +title: 'Browser - HomePage - Manage' +title_meta: 'Browser - HomePage - Manage' +keywords: ['homepage', 'browsers', 'configuration', 'set', 'remove', 'replace'] +description: 'Manages homepage settings for supported browsers on Windows endpoints' +tags: ['chrome', 'edge', 'firefox', 'setup'] +draft: false +unlisted: false +last_update: + date: 2026-10-01 +--- + +## Purpose + +The Browser Homepage Management solution manages homepage settings for supported browsers on **Windows endpoints**. It allows administrators to centrally configure whether a browser homepage should be set, removed, or replaced, and which browsers should be targeted. + +The solution supports the following browsers: + +* **Google Chrome** +* **Microsoft Edge** +* **Brave** +* **Mozilla Firefox** + +The solution uses **NinjaOne custom fields** to define the desired browser homepage configuration and deployment scope. The configuration is then applied through the **Automation : Browser - Homepage - Manage** automation using signed agnostic scripts. + +### Key Capabilities + +1. **Platform Support** + + The solution is designed for **Windows Workstations and Windows Servers**. + +2. **Browser Selection** + + Specify which supported browsers should be managed. The supported values are **Chrome, Edge, Brave, and Firefox**. + +3. **Homepage Actions** + + The solution supports three homepage management actions: + + * **Set** – Sets the specified homepage. + * **Remove** – Removes the configured homepage. + * **Replace** – Replaces the existing homepage with the specified homepage. + +4. **Custom Homepage** + + A specific homepage URL can be configured for the **Set** and **Replace** actions. + +5. **New Tab Enforcement** + + For Chromium-based browsers, the solution can enforce the configured homepage on each new tab instead of allowing the browser's default new tab page. + + This applies to: + + * Google Chrome + * Microsoft Edge + * Brave + +6. **Startup Homepage Enforcement** + + The solution can force the configured homepage to be the only page opened when the browser starts. + +7. **Centralized Configuration** + + Browser homepage settings are managed through Ninja RMM custom fields, allowing the desired configuration to be controlled centrally without modifying the automation or scripts. + +### Important Caveats & Behavior + +1. **Supported Platform** + + The solution is intended for **Windows Workstations and Windows Servers**. The deployment conditions determine whether the automation is triggered for a workstation or server. + +2. **Supported Browsers** + + Only **Chrome, Edge, Brave, and Firefox** are supported. Browser names should be entered using the supported browser values. + +3. **Chromium New Tab Enforcement** + + The **EnforceOnNewTab** setting applies only to Chromium-based browsers: **Chrome, Edge, and Brave**. It does not apply to Firefox. + +4. **Homepage URL** + + The homepage value is required when using the **Set** or **Replace** actions. It is not required for the **Remove** action. + +5. **Enablement** + + The solution only runs on endpoints that are enabled through the **cPVAL Enable Browser Manage** custom field. + +## Associated Content + +### Custom Fields + +| Content | Purpose | +|-----------------------------------------------------|-------------------------------------------------| +| [cPVAL Enable Browser Manage](/docs/d63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750) | Custom Field to select the operating system to manage the Browser homepage for the machines. | +| [cPVAL Browser HomePage Action](/docs/9073ddaa-e5c0-478f-a893-e6b8c423fb3d) | Custom Field to select the desired action to be performed on Browsers Homepage. Set -> To set the Homepage; Remove -> To remove the Homepage; Replace -> To replace the current Homepage. | +| [cPVAL Browser](/docs/117579a5-d7bf-43d5-97e1-ea77163cf7a2) | Custom Field to specify the browser for setting/removing the homepage. Only 'Chrome', 'Edge', 'Brave' and 'Firefox' are acceptable values. | +| [cPVAL Browser Homepage](/docs/bec7d778-7266-46f4-893b-616c0cea5557) | Custom Field to add the string value of the homepage to set in the browser. Only useful with the Set and Replace actions. | +| [cPVAL Browser EnforceOnNewTab](/docs/9e50a4bc-f862-48af-a964-b073cb9cce01) | Custom Field to enforce the homepage on each new tab instead of the new tab page. Only useful with the Set and Replace actions and only works on Chromium Browsers (Brave,Chrome and Edge). | +| [cPVAL Browser EnforceHomepageStartup](/docs/734b02cf-e27d-4bc9-93b6-8054946780f5) | Custom Field to force the homepage to be the only open tab at the startup of the browser. Only useful with the Set and Replace actions. | + +### Automation + +| Name | Purpose | +| ---------------------------------------- | --------------------------------------------------------------------------------------------------------- | +| [Browser - Homepage - Manage](/docs/13d8ac16-33d9-4bf4-b7cb-d8db932c8da6) | Manages browser homepage settings for Chrome, Edge, Brave, and Firefox using signed agnostic scripts. | + + +### Compound Conditions + +| Name | Purpose | +| ---------------------------------------- | --------------------------------------------------------------------------------------------------------- | +| [Manage Browser Homepage - Workstations](/docs/0f23c8a1-f507-4c1d-9d3f-8e1233653c1e) | Triggers the [Automation - Browser - Homepage - Manage](/docs/13d8ac16-33d9-4bf4-b7cb-d8db932c8da6) on Windows Workstations where deployment is enabled for windows workstations from [Custom Field - cPVAL Enable Browser Manage](/docs/d63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750). | +| [Manage Browser Homepage - Servers](/docs/3557a5e1-91f2-4a2b-983c-bf79332ee3ec) | Triggers the [Automation - Browser - Homepage - Manage](/docs/13d8ac16-33d9-4bf4-b7cb-d8db932c8da6) on Windows servers where deployment is enabled for windows servers from [Custom Field - cPVAL Enable Browser Manage](/docs/d63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750). | + +## Implementation + +### Step 1: Create the Following Custom Fields + +Create all the custom fields listed below in Ninja RMM. These are required for the solution to function correctly. + +* [cPVAL Enable Browser Manage](/docs/d63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750) +* [cPVAL Browser HomePage Action](/docs/9073ddaa-e5c0-478f-a893-e6b8c423fb3d) +* [cPVAL Browser](/docs/117579a5-d7bf-43d5-97e1-ea77163cf7a2) +* [cPVAL Browser Homepage](/docs/bec7d778-7266-46f4-893b-616c0cea5557) +* [cPVAL Browser EnforceOnNewTab](/docs/9e50a4bc-f862-48af-a964-b073cb9cce01) +* [cPVAL Browser EnforceHomepageStartup](/docs/734b02cf-e27d-4bc9-93b6-8054946780f5) + +### Step 2: Create the Automation + +Set up the [Browser - Homepage - Manage](/docs/13d8ac16-33d9-4bf4-b7cb-d8db932c8da6) automation that will manage the browser homepage configuration on the targeted Windows endpoints. + +### Step 3: Create the Compound Conditions + +Create the compound conditions that will automatically target the appropriate Windows endpoints. + +* [Manage Browser Homepage - Workstations](/docs/0f23c8a1-f507-4c1d-9d3f-8e1233653c1e) +* [Manage Browser Homepage - Servers](/docs/3557a5e1-91f2-4a2b-983c-bf79332ee3ec) + +The Workstations compound condition targets Windows Workstations where Browser Homepage Management is enabled. + +The Servers compound condition targets Windows Servers where Browser Homepage Management is enabled. + +## FAQ + +### Q: Which platforms are supported? + +> The Browser Homepage Management solution supports **Windows Workstations and Windows Servers**. + +### Q: Which browsers are supported? + +> The solution supports **Chrome, Edge, Brave, and Firefox**. + +### Q: What actions are supported? + +> The solution supports the following actions: +> +> * **Set** – Sets the configured homepage. +> * **Remove** – Removes the configured homepage. +> * **Replace** – Replaces the existing homepage with the configured homepage. + +### Q: When is the Browser Homepage custom field required? + +> The [cPVAL Browser Homepage](/docs/bec7d778-7266-46f4-893b-616c0cea5557) custom field is required when using the **Set** or **Replace** actions. It is not required when using the **Remove** action. + +### Q: Can multiple browsers be managed? + +> Yes. The [cPVAL Browser](/docs/117579a5-d7bf-43d5-97e1-ea77163cf7a2) custom field can be used to specify the supported browsers that should be managed. + +### Q: Does EnforceOnNewTab work with Firefox? + +> No. The **EnforceOnNewTab** setting only applies to Chromium-based browsers: **Chrome, Edge, and Brave**. + +### Q: What happens when Browser Homepage Management is disabled? + +> The endpoint will not be targeted by the Browser Homepage Management compound condition, and the [Automation - Browser - Homepage - Manage](/docs/13d8ac16-33d9-4bf4-b7cb-d8db932c8da6) automation will not be triggered for that endpoint. + +### Q: Why is the automation not running on an endpoint? + +> Verify that: +> * The endpoint is a supported **Windows Workstation or Windows Server**. +> * The [cPVAL Enable Browser Manage](/docs/d63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750) custom field is enabled. +> * The endpoint meets the appropriate Workstation or Server compound condition. +> * The required browser is installed on the endpoint. +> * The Browser Homepage custom fields contain valid configuration values. + +### Q: Is any manual configuration required on the endpoint? + +> No additional manual endpoint configuration is required. The solution uses the configured Ninja RMM custom fields and the Browser Homepage Management automation to apply the settings. + +### Q: Can the homepage be removed after it has been configured? + +> Yes. Set the [cPVAL Browser HomePage Action](/docs/9073ddaa-e5c0-478f-a893-e6b8c423fb3d) custom field to **Remove**. The homepage URL does not need to be configured for the Remove action. + + +## Changelog + +### 2026-10-01 + +- Initial version of the document diff --git a/static/img/docs/117579a5-d7bf-43d5-97e1-ea77163cf7a2/image1.webp b/static/img/docs/117579a5-d7bf-43d5-97e1-ea77163cf7a2/image1.webp new file mode 100644 index 000000000..5e22d97f8 Binary files /dev/null and b/static/img/docs/117579a5-d7bf-43d5-97e1-ea77163cf7a2/image1.webp differ diff --git a/static/img/docs/13d8ac16-33d9-4bf4-b7cb-d8db932c8da6/image1.webp b/static/img/docs/13d8ac16-33d9-4bf4-b7cb-d8db932c8da6/image1.webp new file mode 100644 index 000000000..2f09570bb Binary files /dev/null and b/static/img/docs/13d8ac16-33d9-4bf4-b7cb-d8db932c8da6/image1.webp differ diff --git a/static/img/docs/734b02cf-e27d-4bc9-93b6-8054946780f5/image1.webp b/static/img/docs/734b02cf-e27d-4bc9-93b6-8054946780f5/image1.webp new file mode 100644 index 000000000..ed96dcbdc Binary files /dev/null and b/static/img/docs/734b02cf-e27d-4bc9-93b6-8054946780f5/image1.webp differ diff --git a/static/img/docs/9073ddaa-e5c0-478f-a893-e6b8c423fb3d/image1.webp b/static/img/docs/9073ddaa-e5c0-478f-a893-e6b8c423fb3d/image1.webp new file mode 100644 index 000000000..277769983 Binary files /dev/null and b/static/img/docs/9073ddaa-e5c0-478f-a893-e6b8c423fb3d/image1.webp differ diff --git a/static/img/docs/9e50a4bc-f862-48af-a964-b073cb9cce01/image1.webp b/static/img/docs/9e50a4bc-f862-48af-a964-b073cb9cce01/image1.webp new file mode 100644 index 000000000..3ab5ac2a8 Binary files /dev/null and b/static/img/docs/9e50a4bc-f862-48af-a964-b073cb9cce01/image1.webp differ diff --git a/static/img/docs/bec7d778-7266-46f4-893b-616c0cea5557/image1.webp b/static/img/docs/bec7d778-7266-46f4-893b-616c0cea5557/image1.webp new file mode 100644 index 000000000..63070bdbd Binary files /dev/null and b/static/img/docs/bec7d778-7266-46f4-893b-616c0cea5557/image1.webp differ diff --git a/static/img/docs/d63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750/image1.webp b/static/img/docs/d63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750/image1.webp new file mode 100644 index 000000000..6350f351e Binary files /dev/null and b/static/img/docs/d63f2f2f-d39d-4bcd-8eb5-c4bbbb67b750/image1.webp differ