PSMDB-1743 Documented integration with Imperva DSF

docs/imperva.md

@@ -0,0 +1,46 @@
+# Integration with Imperva Data Security Fabric (DSF) 
+
+!!! note "Version added: [8.0.8-3](release_notes/8.0.8-3.md)"
+
+Integrating [Percona Server for MongoDB Pro](psmdb-pro.md) with [Imperva Data Security Fabric (DSF) :octicons-link-external-16:](https://www.thalestct.com/imperva-data-security-fabric/) by Thales enables enterprise-grade auditing, monitoring, and behavioral analytics for sensitive data activity.
+
+Data Security Fabric (DSF) includes three core components:
+
+* DSF Hub (Sonar): is the central platform that ingests, stores, and normalizes audit data from your MongoDB instances.
+* Database Activity Monitoring (DAM): Enforces policies for access control and behavioral inspection, enabling real-time detection of unauthorized activity or misuse.
+* Data Risk Analytics (DRA): Applies machine learning and behavior modeling to uncover anomalies, prioritize risk, and provide actionable intelligence for security and compliance teams.
+
+Together, these components provide continuous compliance coverage, rapid breach detection, and scalable visibility across hybrid or cloud-hosted MongoDB deployments.
+
+## How it works
+
+Percona Server for MongoDB uses native audit logging that captures detailed user actions, administrative events, and query operations. These audit logs are ingested into the Imperva DSF Hub, where they are normalized, stored securely, and analyzed. Administrators can define policies, monitor activity, and trigger alerts based on access behavior. 
+
+Audit logs can be enriched with the debug symbols available in Percona Server for MongoDB Pro. This enrichment enhances event parsing, improves context accuracy, and supports deep operational visibility.
+
+!!! note 
+
+    Non Percona Customers can include debug symbols by [building Percona Server for MongoDB from the source code](install/source.md).
+
+
+This integration provides the following benefits:
+
+* Deep visibility into MongoDB operations enhanced with debug symbols. 
+* Automated compliance via audit-ready reporting
+* Behavioral threat detection tailored to MongoDB workloads
+* Scalable protection across on-premises, hybrid, and cloud deployments
+
+## Version compatibility
+
+* Percona Server for MongoDB Pro starting with versions 6.0.21-18, 7.0.18-11, 8.0.8-3
+* Imperva DSF version 14.9 or later
+
+## Configuration
+
+For setup instructions, consult the [Percona Server for MongoDB Onboarding Steps
+ :octicons-link-external-16:](https://docs-cybersec.thalesgroup.com/bundle/onboarding-databases-to-sonar-reference-guide/page/Percona-Server-for-MongoDB-Onboarding-Steps_48368154.html).
+
+
+
+
+

mkdocs-base.yml

@@ -25,13 +25,13 @@ theme:
   icon:
     edit: material/file-edit-outline
     view: material/file-eye-outline
-  
+
   features:
     - search.highlight
     - search.share
     - search.suggest
     - navigation.top
-    - navigation.tracking 
+    - navigation.tracking
     - navigation.instant
     - navigation.instant.progress
     - content.tooltips
@@ -41,9 +41,9 @@ theme:
     - content.code.copy
     - content.code.annotate
     - toc.follow
-    
+
   palette:
-    
+
     # Automatic mode based on system preferences
 
     - media: "(prefers-color-scheme)"
@@ -97,10 +97,10 @@ markdown_extensions:
   pymdownx.details: {}
   pymdownx.mark: {}
   pymdownx.smartsymbols: {}
-  pymdownx.tabbed: 
+  pymdownx.tabbed:
       {alternate_style: true}
   pymdownx.tilde: {}
-  pymdownx.superfences: 
+  pymdownx.superfences:
     custom_fences:
       - name: mermaid
         class: mermaid
@@ -109,7 +109,7 @@ markdown_extensions:
       linenums: false
   pymdownx.inlinehilite: {}
   pymdownx.snippets:
-      base_path: 
+      base_path:
         - snippets
         - docs/install
         - docs/
@@ -124,13 +124,13 @@ markdown_extensions:
         custom_icons:
           - _resource/overrides/.icons
 
-       
+
 
 plugins:
 #  section-index: {}
-  search: 
+  search:
     separator: '[\s\-,:!=\[\]()"/]+|(?!\b)(?=[A-Z][a-z])|\.(?!\d)|&[lg]t;'
-  git-revision-date-localized: 
+  git-revision-date-localized:
     enable_creation_date: true
     enabled: !ENV [ENABLED_GIT_REVISION_DATE, True]
   meta-descriptions:
@@ -139,7 +139,7 @@ plugins:
     enable_checks: false
     min_length: 50
     max_length: 160
-  glightbox: 
+  glightbox:
     touchNavigation: false
   git-committers:
     enabled: !ENV [CI, false]
@@ -183,7 +183,7 @@ nav:
   - Home: index.md
   - psmdb-pro.md
   - get-help.md
-  - Get started: 
+  - Get started:
       - Quickstart guides: 'install/index.md'
       - 1. Installation:
         - 'System requirements': 'system-requirements.md'
@@ -198,7 +198,7 @@ nav:
       - "2. Connect to Percona Server for MongoDB": connect.md
       - "3. Manipulate data in Percona Server for MongoDB": crud.md
       - "4. What's next?": what-next.md
-  - Features: 
+  - Features:
       - Feature comparison with MongoDB: comparison.md
       - Storage:
         - "Percona Memory Engine": "inmemory.md"
@@ -224,7 +224,7 @@ nav:
              - With Ping Identity: oidc-ping.md
              - With Keycloak: oidc-keycloak.md
              - OIDC authentication and LDAP authorization: oidc-ldap.md
-        - enable-auth.md  
+        - enable-auth.md
       - Encryption:
         - "Data at rest encryption": "data-at-rest-encryption.md"
         - "Use Vault": vault.md
@@ -233,7 +233,9 @@ nav:
         - "Migrate from keyfile to Vault": encryption-mode-switch.md
         - fips.md
       - fcbis.md
-      - audit-logging.md 
+      - Auditing:
+        - Audit logging: audit-logging.md
+        - Integration with Imperva DSF: imperva.md
       - rate-limit.md
       - log-redaction.md
       - ngram-full-text-search.md
@@ -258,5 +260,5 @@ nav:
       - glossary.md
       - telemetry.md
       - copyright.md
-      - trademark-policy.md 
+      - trademark-policy.md
   - Join Percona Squad: "https://squad.percona.com/mongodb"