Skip to content

Commit 4b4cad3

Browse files
committed
2 parents f088c34 + b53b9c1 commit 4b4cad3

File tree

1 file changed

+30
-6
lines changed

1 file changed

+30
-6
lines changed

README.md

Lines changed: 30 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ See the Checkmk [documentation](https://docs.checkmk.com/latest/en/mkps.html) fo
99
## Plugin Information
1010

1111
The Plugin provides monitoring for the following components:
12+
- Microsoft Entra App Proxy Certificates
1213
- Microsoft Entra App Registration Credentials
1314
- Microsoft Entra CA VPN Certificate
1415
- Microsoft Entra Connect/Cloud Sync
@@ -23,6 +24,7 @@ To access the API, you need a Microsoft Entra tenant and a Microsoft Entra app r
2324

2425
You need at least the following API **application** permissions for your app registration to use all the checks:
2526
- *Application.Read.All*
27+
- *Directory.Read.ALl*
2628
- *Organization.Read.All*
2729

2830
For a more granular options, the required API permissions per check are listed in the next sections.
@@ -43,6 +45,28 @@ When you configure the Special Agent, you have the option to select only the ser
4345
4446
## Check Details
4547

48+
### Microsoft Entra App Proxy Certificates
49+
50+
#### Description
51+
52+
This check monitors the expiration time of custom certificates from Entra app proxies.
53+
54+
#### Checkmk Service Example
55+
56+
<img width="1064" height="59" alt="grafik" src="https://github.com/user-attachments/assets/6d580262-d010-4a71-815b-fedd984bd1e6" />
57+
58+
#### Checkmk Parameters
59+
60+
1. **Certificate expiration**: Specify the lower levels for the Microsoft Entra app proxy certificates expiration time. The default values are 14 days (WARN) and 5 days (CRIT). To ignore the certificate expiration, select "No levels".
61+
62+
#### Microsoft Graph API
63+
64+
**API Permissions**: At least *Directory.Read.All* (Application permission)
65+
66+
**Endpoints**: `https://graph.microsoft.com/beta/applications`, `https://graph.microsoft.com/v1.0/servicePrincipals`
67+
68+
---
69+
4670
### Microsoft Entra App Registration Credentials
4771

4872
#### Description
@@ -55,8 +79,8 @@ This check monitors the expiration time of secrets and certificates from Entra a
5579

5680
#### Checkmk Parameters
5781

58-
1. **Credential Expiration**: Specify the lower levels for the Microsoft Entra app credential expiration time. The default values are 14 days (WARN) and 5 days (CRIT). To ignore the credential expiration, select "No levels".
59-
2. **Exclude Credentials**: Specify a list of credential descriptions that you do not want to monitor.
82+
1. **Credential expiration**: Specify the lower levels for the Microsoft Entra app credential expiration time. The default values are 14 days (WARN) and 5 days (CRIT). To ignore the credential expiration, select "No levels".
83+
2. **Exclude credentials**: Specify a list of credential descriptions that you do not want to monitor.
6084

6185
#### Microsoft Graph API
6286

@@ -78,7 +102,7 @@ This check monitors the expiration time of the Entra Conditional Access VPN cert
78102

79103
#### Checkmk Parameters
80104

81-
1. **Certificate Expiration**: Specify the lower levels for the Microsoft Entra Conditional Access VPN certificate expiration time. The default values are 14 days (WARN) and 5 days (CRIT). To ignore the certificate expiration, select "No levels".
105+
1. **Certificate expiration**: Specify the lower levels for the Microsoft Entra Conditional Access VPN certificate expiration time. The default values are 14 days (WARN) and 5 days (CRIT). To ignore the certificate expiration, select "No levels".
82106

83107
#### Microsoft Graph API
84108

@@ -100,11 +124,11 @@ This check monitors the time since the last Entra Connect/Cloud Sync synchronisa
100124

101125
#### Checkmk Parameters
102126

103-
1. **Time Since Last Sync**: Specify the upper levels for the last sync time from Microsoft Entra Connect/Cloud Sync. The default values are 1 hour (WARN) and 3 hours (CRIT). To ignore the last sync time, select "No levels".
127+
1. **Time since last sync**: Specify the upper levels for the last sync time from Microsoft Entra Connect/Cloud Sync. The default values are 1 hour (WARN) and 3 hours (CRIT). To ignore the last sync time, select "No levels".
104128

105129
#### Microsoft Graph API
106130

107-
**API Permissions**: At least *Organization.Read.All* (Application permission)
131+
**API permissions**: At least *Organization.Read.All* (Application permission)
108132

109133
**Endpoint**: `https://graph.microsoft.com/v1.0/organization/{organizationId}`
110134

@@ -122,7 +146,7 @@ This check monitors the expiration time of certificates from Entra enterprise ap
122146

123147
#### Checkmk Parameters
124148

125-
1. **Certificate Expiration**: Specify the lower levels for the Microsoft Entra SAML app certificate expiration time. The default values are 14 days (WARN) and 5 days (CRIT). To ignore the certificate expiration, select "No levels".
149+
1. **Certificate expiration**: Specify the lower levels for the Microsoft Entra SAML app certificate expiration time. The default values are 14 days (WARN) and 5 days (CRIT). To ignore the certificate expiration, select "No levels".
126150

127151
#### Microsoft Graph API
128152

0 commit comments

Comments
 (0)