Integración SNMP de Planisys ---------------------------- Visión general ^^^^^^^^^^^^^^ Los servidores DNS autoritativos de Planisys soportan **trampas SNMPv2c / SNMPv3** para su integración con sistemas de gestión de red (NMS) empresariales, incluyendo **DX NetOps Spectrum**. Este documento describe: * El **Private Enterprise Number (PEN)** de Planisys * El **PLANISYS-BIND-AUTH-MIB** * Las trampas SNMP soportadas y sus variables * Cómo validar las trampas durante una Prueba de Concepto (PoC) ---- Declaración de integración NMS ------------------------------ Planisys proporciona capacidades de monitorización e integración con sistemas de gestión de red (NMS) mediante **SNMP traps estándar**, soportando **SNMPv2c y SNMPv3 (authPriv)**. La plataforma expone eventos operativos y de servicio a través de **MIBs documentados bajo un Private Enterprise Number (PEN) oficial**, garantizando la estabilidad de los OIDs y la compatibilidad a largo plazo. Las trampas SNMP de Planisys son compatibles con soluciones NMS enterprise tales como **DX NetOps Spectrum, IBM Netcool, HPE Operations Bridge, Zabbix, OpenNMS y plataformas OSS/BSS equivalentes**, permitiendo la correlación de eventos, la gestión de alarmas y la automatización de procesos operativos en entornos Telco. Private Enterprise Number (PEN) de Planisys ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Planisys utiliza un **Private Enterprise Number (PEN)** asignado oficialmente por la Internet Assigned Numbers Authority (IANA): **64835** .. note:: El PEN es un identificador público. **No es una credencial** y no expone información sensible de seguridad. **Proveedor** Planisys **PEN** ``64835`` **OID raíz de la empresa** :: 1.3.6.1.4.1.64835 ---- MIB Autoritativo BIND de Planisys --------------------------------- Nombre del MIB ^^^^^^^^^^^^^^ :: PLANISYS-BIND-AUTH-MIB Propósito ^^^^^^^^^ Este MIB define notificaciones SNMP (trampas) emitidas por **servidores DNS autoritativos de Planisys basados en BIND**, para señalar eventos operativos y de servicio relacionados con DNS. Descarga ^^^^^^^^ :download:`PLANISYS-BIND-AUTH-MIB.mib ` ---- Traps SNMP soportados --------------------- Traps de estado del servicio ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +--------------+------------+-----------------------------------------------+----------------+ | Nombre | Sufijo OID | Descripción | Severidad | +==============+============+===============================================+================+ | dnsSvcDown | ``.0.1001``| El servicio BIND (named) se detuvo o falló | Crítica | +--------------+------------+-----------------------------------------------+----------------+ | dnsSvcUp | ``.0.1002``| El servicio BIND (named) inició correctamente | Informativa | +--------------+------------+-----------------------------------------------+----------------+ ---- Variables comunes de las trampas (Varbinds) ___________________________________________ Todas las trampas definidas en ``PLANISYS-BIND-AUTH-MIB`` incluyen un conjunto consistente de varbinds para facilitar la correlación en los sistemas NMS. +---------------------+----------------+------------------------------------------------+ | Varbind | Tipo | Descripción | +=====================+================+================================================+ | pdnsHostFqdn | DisplayString | FQDN del servidor DNS autoritativo | +---------------------+----------------+------------------------------------------------+ | pdnsEventTimeUtc | DisplayString | Marca temporal del evento en UTC (ISO-8601) | +---------------------+----------------+------------------------------------------------+ | pdnsSeverity | INTEGER | 1=Crítica, 2=Mayor, 3=Menor, 4=Advertencia, | | | | 5=Informativa | +---------------------+----------------+------------------------------------------------+ | pdnsZoneName | DisplayString | Nombre de la zona DNS, o ``na`` si no aplica | +---------------------+----------------+------------------------------------------------+ | pdnsMessage | DisplayString | Descripción legible del evento | +---------------------+----------------+------------------------------------------------+ ---- Ejemplos de carga de traps -------------------------- Servicio BIND detenido ^^^^^^^^^^^^^^^^^^^^^^ :: snmpTrapOID.0 = PLANISYS-BIND-AUTH-MIB::dnsSvcDown pdnsHostFqdn.0 = pdns-1.planisys.net pdnsEventTimeUtc.0 = 2025-12-23T10:42:32Z pdnsSeverity.0 = 1 pdnsZoneName.0 = na pdnsMessage.0 = named detenido o caído en pdns-1.planisys.net Servicio BIND iniciado ^^^^^^^^^^^^^^^^^^^^^^ :: snmpTrapOID.0 = PLANISYS-BIND-AUTH-MIB::dnsSvcUp pdnsHostFqdn.0 = pdns-1.planisys.net pdnsEventTimeUtc.0 = 2025-12-23T10:43:02Z pdnsSeverity.0 = 5 pdnsZoneName.0 = na pdnsMessage.0 = named iniciado en pdns-1.planisys.net ---- Validación de la Prueba de Concepto (PoC) ----------------------------------------- La emisión de trampas puede validarse durante una PoC mediante operaciones simples sobre el servicio. Procedimiento de prueba ^^^^^^^^^^^^^^^^^^^^^^^ En un servidor DNS autoritativo: :: systemctl stop named systemctl start named Comportamiento esperado ^^^^^^^^^^^^^^^^^^^^^^^ * Se emite una trampa ``dnsSvcDown`` cuando ``named`` se detiene * Se emite una trampa ``dnsSvcUp`` cuando ``named`` se inicia * Las trampas se envían al receptor SNMP configurado ---- Compatibilidad con sistemas de gestión de red --------------------------------------------- La implementación SNMP de Planisys es compatible con: * DX NetOps Spectrum * LibreNMS * Zabbix * OpenNMS * Cualquier NMS compatible con SNMPv2c / SNMPv3 Las trampas utilizan el **formato estándar de notificaciones SNMPv2** y no requieren extensiones propietarias. ---- Consideraciones de seguridad ---------------------------- * Las comunidades SNMP o credenciales SNMPv3 **no están definidas en el MIB** * Los destinos de las trampas se configuran por despliegue * SNMPv3 (authPriv) está soportado y es recomendado en producción * Las reglas de firewall deben restringir UDP/162 a hosts NMS autorizados ---- Versionado y estabilidad ------------------------ * Los OID de las trampas definidos en ``PLANISYS-BIND-AUTH-MIB`` son **estables** * Se mantiene compatibilidad hacia atrás entre versiones * Nuevas trampas pueden añadirse en versiones futuras del MIB sin romper integraciones ---- Soporte y contacto ------------------ Para soporte de integración SNMP o MIBs adicionales: * Documentación: https://docs.planisys.net * Soporte: support@planisys.net