Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 0 additions & 42 deletions docs/ninjaone/automations/ssl-certificate-audit.md

This file was deleted.

48 changes: 48 additions & 0 deletions docs/ninjaone/automations/ssl-certificate-expiration-monitoring.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
---
id: '4b6c5595-4336-4e14-a119-c6c7e2c31443'
slug: /4b6c5595-4336-4e14-a119-c6c7e2c31443
title: 'SSL Certificate Expiration Monitoring'
title_meta: 'SSL Certificate Expiration Monitoring'
keywords: ['certificates', 'audit', 'expiration', 'status', 'thumbprint', 'issuer', 'subject', 'client', 'computer']
description: 'Monitors the local machine certificate store for SSL certificates that are expiring soon or have already expired, and reports any that havent already been alerted on.'
tags: ['windows']
draft: false
unlisted: false
last_update:
date: 2026-07-22
---

## Overview

Monitors the local machine certificate store for SSL certificates that are expiring soon or have already expired, and reports any that haven't already been alerted on.

## Sample Run

`Play Button` > `Run Automation` > `Script`
![SampleRun1](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/samplerun1.webp)
![SampleRun2](../../../static/img/docs/4b6c5595-4336-4e14-a119-c6c7e2c31443/image1.webp)

## Dependencies

- [Solution - SSL Certificate Audit](/docs/cf5acc69-183c-4838-9484-2f3d9a247877)

## Parameters

| Name | Example | Accepted Values | Required | Default | Type | Description |
| ---- | ------- | --------------- | -------- | ------- | ---- | ----------- |
| SSL Cert Expiry Threshold | 15 | Numeric Values | False | - | Text | Set the number of days before SSL certificate expiration to detect and report certificates requiring attention. |


## Automation Setup/Import

[Automation Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/scripts/ssl-certificate-expiration-monitoring.ps1)

## Output

- Activity Details

## Changelog

### 2026-07-22

- Initial version of the document
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
id: '3c9e2ed2-f805-4da9-85fb-7fa1d1d146f5'
slug: /3c9e2ed2-f805-4da9-85fb-7fa1d1d146f5
title: 'Windows - Certificates (My) - Local Machine - Audit'
title_meta: 'Windows - Certificates (My) - Local Machine - Audit'
keywords: ['certificates', 'audit', 'expiration', 'status', 'thumbprint', 'issuer', 'subject', 'client', 'computer']
description: 'Audits all certificates in the local machines personal certificate store and flags expired or soon-to-expire certificates.'
tags: ['windows']
draft: false
unlisted: false
last_update:
date: 2026-07-22
---

## Overview

This Script audits all certificates in the local machine's personal certificate store and flags expired or soon-to-expire certificates. It then updates the custom field [cPVAL SSL certificate Audit](/docs/350874e6-7bef-4bff-8fce-f2772acab495) with the SSL certificate details and also sets the custom field [cPVAL Expired SSL Certificates Detected](/docs/2c4efab3-5417-485a-b9cd-7d67ce474fd9) to True if any expired or soon-to-expire certificates are found during the audit.

## Sample Run

`Play Button` > `Run Automation` > `Script`
![SampleRun1](../../../static/img/docs/b97b3d2c-ecc6-42ff-9236-36b14765c9b7/samplerun1.webp)
![SampleRun2](../../../static/img/docs/3c9e2ed2-f805-4da9-85fb-7fa1d1d146f5/image1.webp)

## Dependencies

- [Solution - SSL Certificate Audit](/docs/cf5acc69-183c-4838-9484-2f3d9a247877)
- [Custom field - cPVAL SSL certificate Audit](/docs/350874e6-7bef-4bff-8fce-f2772acab495)
- [cPVAL Expired SSL Certificates Detected](/docs/2c4efab3-5417-485a-b9cd-7d67ce474fd9)

## Parameters

| Name | Example | Accepted Values | Required | Default | Type | Description |
| ---- | ------- | --------------- | -------- | ------- | ---- | ----------- |
| SSL Cert Expiry Threshold | 15 | Numeric Values | False | - | Text | Set the number of days before SSL certificate expiration to detect and report certificates requiring attention. |

**Note** : SSL Cert Expiry Threshold should be similar to [Script : SSL Certificate Expiration Monitoring](/docs/4b6c5595-4336-4e14-a119-c6c7e2c31443) to alert for the certificates that are expired or soon to expire.

## Automation Setup/Import

[Automation Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/scripts/windows-certificates-local-machine-audit.ps1)

## Output

- Activity Details
- Custom Field

## Changelog

### 2026-07-22

- Renamed the script from `SSL Certificate Audit` to `Windows - Certificates (My) - Local Machine - Audit` since this script pulls all certificates and not just SSL certificates on the machine.

### 2026-02-13

- Initial version of the document
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
id: '79d5020a-7487-42ad-9dc3-1cfd7d675be5'
slug: /79d5020a-7487-42ad-9dc3-1cfd7d675be5
title: 'Monitor SSL Cert Expiration - Servers'
title_meta: 'Monitor SSL Cert Expiration - Servers'
keywords: ['certificates', 'audit', 'expiration', 'status', 'thumbprint', 'issuer', 'subject', 'client', 'computer']
description: 'Triggers the Script SSL Certificate Expiration Monitoring automation on Windows workstation'
tags: ['windows']
draft: false
unlisted: false
last_update:
date: 2026-07-22
---

## Summary
Triggers the [Script : SSL Certificate Expiration Monitoring](/docs/4b6c5595-4336-4e14-a119-c6c7e2c31443) automation on Windows Servers where alerting is enabled and [Custom Field : cPVAL Expired SSL Certificates Detected](/docs/2c4efab3-5417-485a-b9cd-7d67ce474fd9) is Set to `True` by [Script : Windows - Certificates (My) - Local Machine - Audit](/docs/3c9e2ed2-f805-4da9-85fb-7fa1d1d146f5). It creates tickets if [Script : SSL Certificate Expiration Monitoring](/docs/4b6c5595-4336-4e14-a119-c6c7e2c31443) detects any expired or soon-to-expire certificate that haven't already been alerted on.

## Details

- **Name:** `Monitor SSL Cert Expiration - Servers`
- **Description:** Triggers the [Script : SSL Certificate Expiration Monitoring](/docs/4b6c5595-4336-4e14-a119-c6c7e2c31443) automation on Windows Servers where alerting is enabled and [Custom Field : cPVAL Expired SSL Certificates Detected](/docs/2c4efab3-5417-485a-b9cd-7d67ce474fd9) is Set to 'True' by [Script : Windows - Certificates (My) - Local Machine - Audit](/docs/3c9e2ed2-f805-4da9-85fb-7fa1d1d146f5). It creates tickets if [Script : SSL Certificate Expiration Monitoring](/docs/4b6c5595-4336-4e14-a119-c6c7e2c31443) detects any expired or soon-to-expire certificate that haven't already been alerted on.
- **Recommended Agent Policies:** `Windows Servers`

## Dependencies

- [Solution - SSL Certificate Audit](/docs/cf5acc69-183c-4838-9484-2f3d9a247877)
- [Ticket Template : SSL Cert Expiration Alerts](/docs/1333942f-f022-4795-956b-ae86f815a636)

## Compound Condition Creation

- [Compound Condition Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/compound-conditions/monitor-ssl-cert-expiration-servers.toml)

## Changelog

### 2026-07-22

- Initial version of the document
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
id: '8c096a91-90f6-4c25-a5dc-745598b19e11'
slug: /8c096a91-90f6-4c25-a5dc-745598b19e11
title: 'Monitor SSL Cert Expiration - Workstations'
title_meta: 'Monitor SSL Cert Expiration - Workstations'
keywords: ['certificates', 'audit', 'expiration', 'status', 'thumbprint', 'issuer', 'subject', 'client', 'computer']
description: 'Triggers the Script SSL Certificate Expiration Monitoring automation on Windows workstation'
tags: ['windows']
draft: false
unlisted: false
last_update:
date: 2026-07-22
---

## Summary
Triggers the [Script : SSL Certificate Expiration Monitoring](/docs/4b6c5595-4336-4e14-a119-c6c7e2c31443) automation on Windows workstations where alerting is enabled and [Custom Field : cPVAL Expired SSL Certificates Detected](/docs/2c4efab3-5417-485a-b9cd-7d67ce474fd9) is Set to `True` by [Script : Windows - Certificates (My) - Local Machine - Audit](/docs/3c9e2ed2-f805-4da9-85fb-7fa1d1d146f5). It creates tickets if [Script : SSL Certificate Expiration Monitoring](/docs/4b6c5595-4336-4e14-a119-c6c7e2c31443) detects any expired or soon-to-expire certificate that haven't already been alerted on.

## Details

- **Name:** `Monitor SSL Cert Expiration - Workstations`
- **Description:** Triggers the [Script : SSL Certificate Expiration Monitoring](/docs/4b6c5595-4336-4e14-a119-c6c7e2c31443) automation on Windows workstations where alerting is enabled and [Custom Field : cPVAL Expired SSL Certificates Detected](/docs/2c4efab3-5417-485a-b9cd-7d67ce474fd9) is Set to 'True' by [Script : Windows - Certificates (My) - Local Machine - Audit](/docs/3c9e2ed2-f805-4da9-85fb-7fa1d1d146f5). It creates tickets if [Script : SSL Certificate Expiration Monitoring](/docs/4b6c5595-4336-4e14-a119-c6c7e2c31443) detects any expired or soon-to-expire certificate that haven't already been alerted on.
- **Recommended Agent Policies:** `Windows Workstations`

## Dependencies

- [Solution - SSL Certificate Audit](/docs/cf5acc69-183c-4838-9484-2f3d9a247877)
- [Ticket Template : SSL Cert Expiration Alerts](/docs/1333942f-f022-4795-956b-ae86f815a636)

## Compound Condition Creation

- [Compound Condition Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/compound-conditions/monitor-ssl-cert-expiration-workstations.toml)

## Changelog

### 2026-07-22

- Initial version of the document
7 changes: 6 additions & 1 deletion docs/ninjaone/compound-conditions/ssl-audit-servers.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ keywords: ['certificates', 'audit', 'expiration', 'status', 'thumbprint', 'issue
description: 'This compound condition performs SSL Certificate Audit once per day on Windows servers where auditing is enabled from `cPVAL Enable SSL Cert Audit` custom field. If set to Disable, the audit will not be performed.'
tags: ['windows']
draft: false
unlisted: false
unlisted: true
last_update:
date: 2026-02-16
---
Expand All @@ -31,6 +31,11 @@ This compound condition performs SSL Certificate Audit once per day on Windows s

## Changelog

### 2026-07-20

- Deprecated [Compound Condition : SSL Audit - Servers](/docs/e38129a0-21bf-45fc-b6da-528312973aa0) as [Task : Audit Local Machine Certificates](/docs/f83dd443-cd43-45ce-8f05-a09e78b9ac0d) will run the Audit script on all windows machines.


### 2026-02-13

- Initial version of the document
6 changes: 5 additions & 1 deletion docs/ninjaone/compound-conditions/ssl-audit-workstations.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ keywords: ['certificates', 'audit', 'expiration', 'status', 'thumbprint', 'issue
description: 'This compound condition performs SSL Certificate Audit once per day on Windows Workstations where auditing is enabled from `cPVAL Enable SSL Cert Audit` custom field. If set to Disable, the audit will not be performed.'
tags: ['windows']
draft: false
unlisted: false
unlisted: true
last_update:
date: 2026-02-16
---
Expand All @@ -32,6 +32,10 @@ This compound condition performs SSL Certificate Audit once per day on Windows W

## Changelog

### 2026-07-20

- Deprecated [Compound Condition : SSL Audit - Servers](/docs/e38129a0-21bf-45fc-b6da-528312973aa0) and [Compound Condition : SSL Audit - Workstations](/docs/d6082c07-16ba-4b32-8eee-c01384378ac7) as [Task : Audit Local Machine Certificates](/docs/f83dd443-cd43-45ce-8f05-a09e78b9ac0d) will run the Audit script on all windows machines.

### 2026-02-16

- Initial version of the document
9 changes: 7 additions & 2 deletions docs/ninjaone/custom-fields/cpval-enable-ssl-cert-audit.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@ keywords: ['certificates', 'audit', 'expiration', 'status', 'thumbprint', 'issue
description: 'Custom Field to enable SSL Certificates Audit'
tags: ['windows']
draft: false
unlisted: false
unlisted: true
last_update:
date: 2026-02-16
date: 2026-07-20
---

## Summary
Expand All @@ -23,6 +23,7 @@ Select the operating system for which SSL Certificate Audit should be enabled. U


## Dependencies

- [Solution - SSL Certificate Audit](/docs/cf5acc69-183c-4838-9484-2f3d9a247877)

## Custom Field Creation
Expand All @@ -35,6 +36,10 @@ Select the operating system for which SSL Certificate Audit should be enabled. U

## Changelog

### 2026-07-20

- Deprecating this Custom Field, since its an Audit solution and no longer be controlled by the custom field.

### 2026-02-13

- Initial version of the document
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
id: '60d87a2b-e5ba-4aef-bbc8-35d60d101889'
slug: /60d87a2b-e5ba-4aef-bbc8-35d60d101889
title: 'cPVAL Enable SSL Cert Expiration Alerts'
title_meta: 'cPVAL Enable SSL Cert Expiration Alerts'
keywords: ['certificates', 'audit', 'expiration', 'status', 'thumbprint', 'issuer', 'subject', 'client', 'computer']
description: 'Custom Field to select the operating systems on which SSL Certificate Expiration Alerts should be enabled.'
tags: ['windows']
draft: false
unlisted: false
last_update:
date: 2026-07-22
---

## Summary

Select the operating systems for which SSL Certificate Expiration Alerts should be enabled. It will detect expired and approaching expiration certificates based on configured threshold and generate alerts for the selected operating system.

## Details

| Label | Field Name | Definition Scope | Type | Required | Option Value | Default Value | Technician Permission | Automation Permission | API Permission | Custom Field Tab Name |
| ----- | ---- | ---------------- | ---- | -------- | ------------ | ------------- | --------------------- | --------------------- | -------------- | ----------- |
| cPVAL Enable SSL Cert Expiration Alerts | cpvalEnableSslCertExpirationAlerts | Organization, Location, Device | DropDown | False | Disable, Windows, Windows Workstations, Windows Servers | | Editable | Read/Write | Read/Write | SSL Certificate |

## Dependencies

- [Solution - SSL Certificate Audit](/docs/cf5acc69-183c-4838-9484-2f3d9a247877)

## Custom Field Creation

- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-enable-ssl-cert-expiration-alert.toml)

## Sample Screenshot

![Image](../../../static/img/docs/60d87a2b-e5ba-4aef-bbc8-35d60d101889/image1.webp)

## Changelog

### 2026-07-22

- Initial version of the document
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
id: '2c4efab3-5417-485a-b9cd-7d67ce474fd9'
slug: /2c4efab3-5417-485a-b9cd-7d67ce474fd9
title: 'cPVAL Expired SSL Certificates Detected'
title_meta: 'cPVAL Expired SSL Certificates Detected'
keywords: ['certificates', 'audit', 'expiration', 'status', 'thumbprint', 'issuer', 'subject', 'client', 'computer']
description: 'This custom field is updated by the `Windows - Certificates (My) - Local Machine - Audit` script to `True` when an expired certificate or a certificate approaching expiration date is detected on the device.'
tags: ['windows']
draft: false
unlisted: false
last_update:
date: 2026-07-22
---

## Summary
This custom field is updated by the [Script : Windows - Certificates (My) - Local Machine - Audit](/docs/3c9e2ed2-f805-4da9-85fb-7fa1d1d146f5) and set to `True` when an expired certificate or a certificate approaching expiration date is detected on the device.

## Details

| Label | Field Name | Definition Scope | Type | Required | Default Value | Technician Permission | Automation Permission | API Permission | Custom Field Tab Name |
| ----- | ---- | ---------------- | ---- | -------- | ------------- | --------------------- | --------------------- | -------------- | ----------- |
|cPVAL Expired SSL Certificates Detected|cpvalExpiredSslCertificatesDetected| `Device` | Text | False | | Editable | Read_Write | Read_Write | SSL Certificate |

## Dependencies

- [Solution - SSL Certificate Audit](/docs/cf5acc69-183c-4838-9484-2f3d9a247877)

## Custom Field Creation

- [Custom Field Configuration](https://github.com/ProVal-Tech/ninjarmm/blob/main/custom-fields/cpval-expired-ssl-certificates-detected.toml)

## Sample Screenshot

![Image](../../../static/img/docs/2c4efab3-5417-485a-b9cd-7d67ce474fd9/image1.webp)

## Changelog

### 2026-07-22

- Initial version of the document

Loading
Loading