Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Por motivos de brevedad, puede sustituir cualquier sistema externo en el que me cuando se refiera a NMIS a continuación (cuando esté implementado).

NOTA : Los usuarios de Redhat  de RedHat 8 deberán editar la integración y agregar credenciales. Las integraciones no funcionarán localmente para Redhat RedHat 8 en este momento (sin credenciales). Nuestro objetivo es abordar esto lo antes posible. Agregue credenciales , y el problema estará resuelto. Disculpas por los inconvenientes que esto pueda ocasionar.

"Simplemente funciona" con NMIS

...

Si está utilizando Open-AudIT en Windows o si su servidor NMIS no está en su servidor Open-AudIT (en el caso de algunas instalaciones de Linux), deberá proporcionar las credenciales de acceso y una URL al NMIS remoto , pero eso es ¡todosy ¡eso es todo! Sí, las integraciones entre NMIS y Open-AudIT incluso funcionan ahora con Open-AudIT basado en Windows.

Creando una Integración

Como de costumbre, vaya a menu a Menu → Manage → Integrations → Create Integration. Como se indicó anteriormente, si se está ejecutando en Linux y tiene NMIS en el mismo servidor, no necesita hacer nada más que hacer clic en 'EnviarSubmit'. 

Si está en Windows o su servidor NMIS es remoto, deberá proporcionar la URL, el nombre de usuario y la contraseña para acceder a ese servidor.

Arriba están los únicos elementos obligatorios .

Si desea profundizar y personalizar la Integración, haga clic en el botón Advanced.

...

Puede seleccionar los dispositivos que se integrarán eligiendo cualquier atributo en la tabla del sistema (dispositivo) y haciendo coincidir (consulte el menu → Menu → Admin → Database → List Tables → system System for a list of fields). Una coincidencia de atributo solo puede coincidir con un valor único.

Si desea ejecutar un Descubrimiento en un dispositivo proporcionado externamente, seleccione la opción y cuando se cree la Integración, entonces verá el Descubrimiento.

¿Qué pasa con los campos que quiero de NMIS que no están en Open-AudIT? . Cualquier campo del sistema externo (NMIS) que no exista en Open-AudIT se creará automáticamente, como campos personalizados de Open-AudIT.

...

De forma predeterminada, integramos todos los dispositivos con su atributo nmis_manage establecido en 'y'. Con la versión 4.2.0 también enviamos una regla que dice "Si si descubrimos un dispositivo y tiene un OID SNMP válido, marque ese dispositivo como administrado por NMIS". Obviamente, puede desactivar esto si no es lo que desea.

 Para Para seleccionar los dispositivos que se integrarán, usamos nmis_manage=y, pero puede que le guste (por ejemplo) type=router. También puede utilizar un grupo o una consulta si prefiere algo más complejo.

Nuestra integración predeterminada también permite un descubrimiento en cualquier dispositivo suministrado externamente. Por lo tanto, enviamos un descubrimiento predeterminado para la Integración predeterminada Predeterminada listo para usar. Estos utilizan las reglas de coincidencia predeterminadas, pero también permiten la coincidencia en la dirección IP.

Hablando de descubrimientos, en la versión 4.2.0 también enviamos un descubrimiento de subred para la subred en la que está instalado el servidor Open-AudIT; consulte aquí las Notas de la versión de Open-AudIT v4.2.0 .

Las integraciones se pueden programar según Descubrimientos, Consultas, et aletc.


Explicación del atributo de

...

Integración

A continuación, se muestran explicaciones de los atributos utilizados por una integración.


create_internal_from_external: Al integrar dispositivos del sistema externo, si el dispositivo no existe en Open-AudIT, ¿debemos crearlo?
update_internal_from_external: Al integrar dispositivos del sistema externo, si el dispositivo se ha actualizado en el sistema externo, ¿debemos actualizarlo en Open-AudIT?
discovery_run: Cuando recuperamos un dispositivo externo, ¿deberíamos ejecutar el descubrimiento en él?

select_internal_type: ¿Cómo debemos seleccionar los dispositivos para integrarlos (usando un Atributo, una Consulta o un Grupo)?
select_internal_attribute: El atributo a probar (de la tabla 'sistema').
select_internal_value: Este artículo debe coincidir con el valor del atributo seleccionado.

create_external_from_internal: Si un dispositivo Open-AudIT no está en el sistema externo, ¿deberíamos crearlo?
update_external_from_internal: Si se ha cambiado un dispositivo Open-AudIT, deberíamos actualizar el sistema externo.
delete_external_from_internal: Si un dispositivo remoto no existe en los dispositivos seleccionados de Open-AudIT, ¿deberíamos eliminarlo del sistema remoto?

select_external_type: Qué dispositivos debe crear Open-AudIT desde el sistema remoto (si corresponde). Usando Todo, Ninguno o un Atributo dado.
select_external_attribute: El atributo a probar (debe coincidir con un nombre de campo externo de abajo).
select_external_value: Este artículo debe coincidir con el valor del atributo seleccionado.

...

Los campos asociados con una integración se almacenan en la base de datos como una matriz JSON de objetos. Cada campo tiene los siguientes atributos:

internal_field_name : Este debe ser el nombre de campo completo en la base de datos. Actualmente se admiten columnas del sistema, campos y tablas de credenciales. Por ejemplo: system.nmis_role.

external_field_name : el  El nombre completo devuelto por el sistema externo.  EGPor ejemplo: para NMIS usamos configuration.roleType.

prioridad : cuando  Cuando se combinan dispositivos, qué sistema es la fuente autorizada de información.

valor_predeterminado : si  Si no hay ningún valor presente, proporcione este valor. EG Por ejemplo: para system.nmis_group/configuraion.group usamos Open-AudIT.

matching_attribute : ¿Deberíamos usar este valor para hacer coincidir los dispositivos externos e internos? Nuestra integración predeterminada usa IP y UUID aquí. Si alguno de estos coincide entre el dispositivo externo y el interno, consideramos que son el mismo dispositivo.

external_field_type : cuando  Cuando estamos convirtiendo un dispositivo seleccionado internamente en un objeto para el sistema externo, ¿cuáles deberían ser los datos externos? EG Por ejemplo: enterointeger, cadenastring, etc.


Tipos de campos externos

texto : un Un campo de texto.

entero : un Un número.

bool : verdadero Verdadero o falso Falso (en contexto JSON).

bool_one_zero : si Si el campo local es verdadero (bool) o y (cadenastring) o Y (cadenastring) o 1 (enterointeger), establezca los datos externos en 1.

bool_y_n : Si el campo local es verdadero (bool) o y (cadenastring) o Y (cadenastring) o 1 (enterointeger), establezca los datos externos en y.

capitalizar capitalize: establece Establece el texto externo en la versión en mayúscula de los datos internos.

Inferior lower: establece Establece el texto externo en minúsculas.

superior upper: establece Establece el texto externo en mayúsculas.

datetime_now : la La fecha y hora actuales en el formato "Ymd Y-m-d H:i:s".

datetime_Y -md m-d H:i:s: el El valor interno, reformateado en este formato.

date_now : la La fecha actual en formato "YmdY-m-d".

date_Y-md : el m-d: El valor interno, reformateado en este formato.

date_m-dY d-Y: el valor interno, reformateado en este formato.

date_d-mY m-Y: el valor interno, reformateado en este formato.

...

Después de que se haya creado una integraciónIntegración, cuando vea los detalles de una integraciónIntegración, verá un campo llamado DepurarDebug. Está configurado en no de forma predeterminada. Cambiarlo a yes proporciona un registro adicional cuando se ejecuta una integración. La depuración no debe dejarse como yes. Esto se debe a que la salida de depuración contendrá todo lo recuperado de sistemas externos, incluidos elementos como las credenciales WMI y SNMP. La opción de depuración debe usarse solo cuando ha ocurrido un problema y desea profundizar para ver si puede determinar por qué.


Ejemplos

...

con capturas de pantalla

Crear una nueva integración (después de hacer clic en el botón Avanzado)

Los registros de una ejecución de

...

Integración

Esquema de base de datos

El esquema de la base de datos se puede encontrar en la aplicación si el usuario tiene el permiso de lectura (database:: base de datos read), yendo al menú: Admin -> Database -> List Tables, luego haciendo clic en el botón de detalles de la tabla.

...

Puede acceder a la colección utilizando la API normal basada en Open-AudIT JSON. Como cualquier otra colección. Consulte la  documentación la documentación de la API de Open-AudIT para obtener más detalles.


...

Pre Open-

...

AudIT 4.2.0

Introducción

El punto final de Integraciones, le permite definir una integración Integración que luego puede usar para importar y exportar datos de Open-AudIT a un sistema externo. En la actualidad, el único tipo de integración admitido es "nmis".

Las integraciones son una característica profesional Profesional y empresarialEmpresarial.

Se están introduciendo integraciones en Open-AudIT 3.1.0 con el fin de ampliar el concepto a medida que se avanza en el desarrollo.

Requisito previoPrerrequisitos

Para ejecutar una integraciónIntegración, deberá descargar oa-nmis-integration.exe (este es un binario de Linux) y colocarlo en /usr/local/omk/bin

El binario está disponible aquí: https://dl-openaudit.opmantek.com/ oa-nmis-integration.exe

Asegúrese de que sea ejecutable ejecutando lo siguiente.mediante el siguiente comando:

chmod +x /usr/local/omk/bin/oa-nmis-integraionintegration.exe

Este archivo se incluirá en versiones futuras de Open-AudIT para Linux.

¿Como ¿Cómo funciona?

Puede definir una integración Integración y utilizarla para exportar dispositivos Open-AudIT a NMIS. De forma predeterminada, solo se exportarán los dispositivos con el atributo nmis_manage establecido en 'y'. Esto es completamente personalizable.

Para obtener una vista más detallada, consulte consulte Integración OpenAudIT-NMIS .

Las integraciones se pueden programar como otras tareas. Primero defina su integraciónIntegración, luego cree la tarea y seleccione integración Integration en el menú desplegable de tiposType.

Configurar dispositivos para administrar

De forma predeterminada, solo los dispositivos con el atributo "nmis_manage" establecido en y 'se exportarán a NMIS. Puede usar la funcionalidad Bulk Edit dentro de Open-AudIT para configurar rápidamente el atributo "Administrar en Manage in NMIS" solo en los dispositivos que necesita. También puede configurar dispositivos individuales para que se administren en la pantalla de detalles del dispositivo. Seleccione el elemento del menú Detalles "Details" de Opmantek en el lado izquierdo y edite el campo "Administrar en Manage in NMIS".  

También puede configurar los otros campos para que se envíen a NMIS como desee, ya sea de forma individual o mediante el Bulk Edit.

Verificar la lista de dispositivos

Una vez que haya establecido el atributo en los dispositivos seleccionados, puede ejecutar la consulta de integración predeterminada para asegurarse de que la lista de dispositivos resultante sea la que espera. Vaya  Vaya al menú → Informe Report Otro → Integración predeterminada para Other → Integration Default for NMIS. 

Creando una Integración

Se puede crear una entrada de integración Integración usando la interfaz web si el usuario actual que inició sesión tiene un rol que contiene el permiso para crearla (integrations::create). Vaya  Vaya al menú: Administrar Manage -> Integraciones Integrations -> Crear integraciones. Proporcione Create Integrations. Proporcione un nombre para la integración, seleccione una organización y proporcione sus credenciales. De  De forma predeterminada, todos los dispositivos con su atributo nmis_manage se seleccionarán para la integración. Si  Si desea otra selección de dispositivos, haga clic en el botón Avanzado Advanced y seleccione una consulta diferente que se utilizará para seleccionar su lista de dispositivos. Puede  Puede crear una consulta personalizada de la misma manera que lo hace con cualquier otra consulta normal, consultevea: Consultas .


 



Ejecutando una integración

Después de crear la entrada de integraciónIntegración, debería estar en la página de detalles de la entrada de integracionesIntegraciones. En  En el encabezado del panel en la parte superior derecha de la página hay un grupo de botones. El  El botón que parece un icono de "reproducción" antiguo (un triángulo) ejecutará esta integraciónIntegración.

Si está en la página de la lista de integracionesIntegraciones, en el lado izquierdo hay un triángulo verde, el mismo icono que en la página de detalles. Haga  Haga clic en eso y se ejecutará la integraciónIntegración.



En breve, debería ver los registros de la integración Integración en ejecución (es posible que deba hacer clic en el botón "actualizar" de su navegador para ver los registros actualizados).

Los dispositivos seleccionados se importarán a NMIS, incluidas sus credenciales. Serán  Serán asignados al grupo Open-AudIT dentro de NMIS. Esto  Esto se puede configurar por dispositivo; consulte consulte Cómo editar en bloque los atributos del dispositivo para  para obtener más información. 

También puede utilizar Tareas Tasks para programar una integración Integración para que se ejecute cuando lo necesite.

Una vez que los dispositivos se hayan exportado a NMIS, después de que NMIS haya ejecutado un ciclo de recopilación / sondeocollect o un poll cycle, deberían aparecer los datos relevantes dentro de NMIS.

Ver detalles de integracionesIntegraciones

Vaya al menú: Administrar Manage-> Integraciones > Integrations -> Lista de integracionesList Integrations.
Verá una lista de integracionesIntegraciones. Puede  Puede ver una integración Integración haciendo clic en el icono de vista azul. También  También puede editar o eliminar integracionesIntegraciones.


Esquema de base de datos

El esquema de la base de datos se puede encontrar en la aplicación si el usuario tiene permiso de lectura (database:: base de datos read) yendo al menú: Admin -> Database -> List Tables, luego haciendo clic en el botón de detalles de la tabla.


API / acceso web

Puede acceder a la colección utilizando la API normal basada en Open-AudIT JSON. Como  Como cualquier otra colección. Consulte la  documentación de la  Consulte la  documentación de la API de Open-AudIT para  para obtener más detalles.