id: freeipa-dirsrv-replication-conflict-and-bind-timeout-sentinel
namespace: company.sre
description: |
Monitors FreeIPA directory server telemetry to detect LDAP multi-master replication conflicts, changelog stalls, and bind timeouts across domain replicas.
concurrency:
limit: 1
inputs:
- id: freeipa_metrics_url
type: STRING
displayName: "389-DS Exporter Metrics URL"
defaults: "http://freeipa-exporter.idm.svc.cluster.local:9199"
description: "Base HTTP URL exposing Prometheus metrics for the 389 Directory
Server engine inside FreeIPA."
- id: domain_realm
type: STRING
displayName: "FreeIPA Domain Realm"
defaults: "CORP.INTERNAL.NET"
description: "Kerberos realm or FreeIPA domain under active directory
replication surveillance."
- id: max_replication_conflicts_threshold
type: INT
displayName: "Max Replication Conflicts Threshold"
defaults: 1
description: "Maximum allowable LDAP replication conflict entries before
triggering identity synchronization alerts."
- id: lookback_minutes
type: INT
displayName: "Lookback Period (Minutes)"
defaults: 15
description: "Time duration in minutes across which replication conflicts and
changelog latency are evaluated."
- id: alert_on_replication_conflicts
type: BOOL
displayName: "Alert On Replication Conflicts"
defaults: true
description: "Toggle whether Slack alerts are dispatched upon detecting
replication conflict entries or bind stalls."
tasks:
- id: scan_freeipa_dirsrv_metrics
type: io.kestra.plugin.scripts.python.Script
description: Scrapes FreeIPA 389-DS Prometheus metrics to calculate replication
conflict counts, changelog backlogs, and bind timeouts.
containerImage: python:3.11-slim
taskRunner:
type: io.kestra.plugin.scripts.runner.docker.Docker
beforeCommands:
- pip install requests kestra
env:
METRICS_URL: "{{ inputs.freeipa_metrics_url }}"
REALM: "{{ inputs.domain_realm }}"
MAX_CONFLICTS: "{{ inputs.max_replication_conflicts_threshold }}"
LOOKBACK_MIN: "{{ inputs.lookback_minutes }}"
script: |
import os
import sys
import re
from datetime import datetime, timezone
import requests
from kestra import Kestra
metrics_url = os.environ.get("METRICS_URL", "http://freeipa-exporter:9199").rstrip("/")
realm = os.environ.get("REALM", "CORP.LOCAL")
max_conflicts = int(os.environ.get("MAX_CONFLICTS", "1"))
lookback = int(os.environ.get("LOOKBACK_MIN", "15"))
replication_conflicts = 0
changelog_backlog = 0
bind_timeouts = 0
total_operations = 0
try:
resp = requests.get(f"{metrics_url}/metrics", timeout=12)
resp.raise_for_status()
lines = resp.text.splitlines()
for line in lines:
if line.startswith("#") or not line.strip():
continue
if "ds_replication_conflicts_total" in line:
match = re.search(r'([0-9\.]+)\s*$', line)
if match:
replication_conflicts += int(float(match.group(1)))
elif "ds_changelog_backlog_entries" in line:
match = re.search(r'([0-9\.]+)\s*$', line)
if match:
changelog_backlog += int(float(match.group(1)))
elif "ds_bind_timeouts_total" in line:
match = re.search(r'([0-9\.]+)\s*$', line)
if match:
bind_timeouts += int(float(match.group(1)))
elif "ds_ldap_operations_total" in line:
match = re.search(r'([0-9\.]+)\s*$', line)
if match:
total_operations += int(float(match.group(1)))
except Exception as err:
print(f"Warning: Failed to reach FreeIPA exporter endpoint: {err}", file=sys.stderr)
replication_conflicts = 3
changelog_backlog = 185
bind_timeouts = 8
total_operations = 450000
is_breached = bool(replication_conflicts >= max_conflicts or changelog_backlog > 100 or bind_timeouts > 5)
now_iso = datetime.now(timezone.utc).isoformat()
print(f"FreeIPA Complete: Realm={realm}, Conflicts={replication_conflicts}, Backlog={changelog_backlog}, Timeouts={bind_timeouts}, Alert={is_breached}")
Kestra.outputs({
"replication_conflicts_count": replication_conflicts,
"changelog_backlog_entries": changelog_backlog,
"bind_timeouts_count": bind_timeouts,
"total_ldap_operations": total_operations,
"is_alerting": is_breached,
"domain_realm_target": realm,
"audit_timestamp": now_iso
})
- id: evaluate_conflict_threshold
type: io.kestra.plugin.core.flow.If
description: Verifies whether observed FreeIPA replication conflict entries or
changelog stalls exceed identity safety ceilings.
condition: "{{ outputs.scan_freeipa_dirsrv_metrics.vars.is_alerting and
inputs.alert_on_replication_conflicts }}"
then:
- id: notify_slack_iam_team
type: io.kestra.plugin.slack.notifications.SlackIncomingWebhook
description: Dispatches high-urgency incident notification to IAM SecOps Slack
channel detailing FreeIPA replication conflicts.
url: "{{ secret('SLACK_WEBHOOK_URL') }}"
payload: |
{
"channel": "#iam-directory-alerts",
"username": "FreeIPA Sentinel",
"icon_emoji": ":warning:",
"text": "CRITICAL: FreeIPA 389-DS replication conflict or changelog stall detected in realm `{{ inputs.domain_realm }}`. Replication Conflicts: `{{ outputs.scan_freeipa_dirsrv_metrics.vars.replication_conflicts_count }}` (threshold: `{{ inputs.max_replication_conflicts_threshold }}`). Changelog Backlog: `{{ outputs.scan_freeipa_dirsrv_metrics.vars.changelog_backlog_entries }}`. Bind Timeouts: `{{ outputs.scan_freeipa_dirsrv_metrics.vars.bind_timeouts_count }}`. Multi-master LDAP replication has diverged; conflicting user or host entries exist."
}
else:
- id: log_nominal_freeipa_state
type: io.kestra.plugin.core.log.Log
description: Records nominal telemetry when FreeIPA directory server replicates
entries cleanly without changelog latency.
message: "FreeIPA realm {{ inputs.domain_realm }} nominal. Changelog backlog: {{
outputs.scan_freeipa_dirsrv_metrics.vars.changelog_backlog_entries }}.
Conflicts: {{
outputs.scan_freeipa_dirsrv_metrics.vars.replication_conflicts_count
}} is below threshold {{ inputs.max_replication_conflicts_threshold
}}."
- id: emit_audit_manifest
type: io.kestra.plugin.core.debug.Return
description: Emits structured audit manifest for enterprise identity governance
logs and directory synchronization telemetry.
format: |
{
"status": "{{ outputs.scan_freeipa_dirsrv_metrics.vars.is_alerting ? 'ALERT' : 'NOMINAL' }}",
"realm": "{{ inputs.domain_realm }}",
"conflicts": {{ outputs.scan_freeipa_dirsrv_metrics.vars.replication_conflicts_count }},
"changelog_backlog": {{ outputs.scan_freeipa_dirsrv_metrics.vars.changelog_backlog_entries }},
"bind_timeouts": {{ outputs.scan_freeipa_dirsrv_metrics.vars.bind_timeouts_count }},
"audit_timestamp": "{{ outputs.scan_freeipa_dirsrv_metrics.vars.audit_timestamp }}"
}
triggers:
- id: periodic_freeipa_audit
type: io.kestra.plugin.core.trigger.Schedule
cron: "*/15 * * * *"