Grupo de mandatos AuditNotificationCommands para el objeto AdminTask

Puede utilizar el lenguaje de script Jython para gestionar el sistema de auditoría de seguridad con la herramienta wsadmin. Utilice los mandatos y parámetros del grupo AuditNotificationCommands para configurar y gestionar notificaciones de auditoría y supervisores de notificación de auditoría.

Nota: En este tema se hace referencia a uno o más de los archivos de registro del servidor de aplicaciones. Como alternativa recomendada, puede configurar el servidor para utilizar la infraestructura de registro y rastreo HPEL en lugar de utilizar los archivos SystemOut.log , SystemErr.log, trace.log y activity.log en sistemas distribuidos y de IBM® i. Puede también utilizar HPEL junto con sus recursos de registro nativos de z/OS. Si utiliza HPEL, puede acceder a toda la información de registro y rastreo utilizando la herramienta de línea de mandatos LogViewer desde el directorio bin de perfil de servidor. Consulte la información sobre la utilización de HPEL para resolver problemas de aplicaciones para obtener más información sobre la utilización de HPEL.

createAuditNotification

El mandato createAuditNotification crea un objeto de notificación de auditoría en el archivo de configuración audit.xml.

El usuario debe tener el rol administrativo de auditor para ejecutar este mandato.

Objeto de destino

Ninguno.

Parámetros necesarios

-notificationName
Especifica el nombre exclusivo para asignar al objeto de la notificación de auditoría. (String, obligatorio)
-logToSystemOut
Especifica si el sistema anota cronológicamente las notificaciones en el archivo SystemOut.log. (Boolean, obligatorio)
-sendEmail
Especifica si se van a enviar a través del correo electrónico las notificaciones de anomalía del subsistema de auditoría de seguridad. (Boolean, necesario)

Parámetros opcionales

-emailList
Especifica la lista de correo electrónico adonde se envían las notificaciones de anomalía de subsistema de auditoría de seguridad. (String, opcional)
-emailFormat
Especifica el formato del correo electrónico. Especifique HTML para el formato HTML o TEXT para el formato del texto. (String, opcional)

Valor de retorno

El mandato devuelve el ID de referencia abreviado del nuevo objeto de notificación de auditoría, tal como se indica en la salida de ejemplo siguiente:
WSNotification_1184690835390

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.createAuditNotification('[-notificationName mynotification -logToSystemOut 
    true -sendEmail true -emailList admin@mycompany.com(smtp-server.mycompany.com) 
    -emailFormat HTML]')
  • Utilizando la lista Jython:
    AdminTask.createAuditNotification(['-notificationName', 'mynotification', '-logToSystemOut', 
    'true', '-sendEmail', 'true', '-emailList', 'admin@mycompany.com(smtp-server.mycompany.com)', 
    '-emailFormat', 'HTML'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.createAuditNotification('-interactive')

createAuditNotificationMonitor

El mandato createAuditNotificationMonitor crea un objeto de supervisor de notificación de auditoría para el sistema de auditoría de seguridad. Este objeto supervisa el subsistema de auditoría de seguridad para buscar posibles anomalías.

El usuario debe tener el rol administrativo de auditor para ejecutar este mandato.

Objeto de destino

Ninguno.

Parámetros necesarios

-monitorName
Especifica el nombre exclusivo del objeto de supervisión de notificación de auditoría. (String, obligatorio)
-notificationRef
Especifica el ID de referencia del objeto de notificación de auditoría. (String, obligatorio)
-enable
Especifica si se va a habilitar el supervisor de notificación de auditoría. (Boolean, obligatorio)

Valor de retorno

El mandato devuelve el formato abreviado del ID de referencia del supervisor de notificación de auditoría, como se indica en la salida de ejemplo siguiente:
AuditNotificationMonitor_1184695615171

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.createAuditNotificationMonitor('-monitorName mymonitor -notificationRef 
    WSNotification_1184690835390 -enable true')
  • Utilizando la lista Jython:
    AdminTask.createAuditNotificationMonitor(['-monitorName', 'mymonitor', '-notificationRef', 
    'WSNotification_1184690835390', '-enable', 'true'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.createAuditNotificationMonitor('-interactive')

deleteAuditNotification

El mandato deleteAuditNotification suprime un objeto de notificación de auditoría del archivo de configuración audit.xml .

El usuario debe tener el rol administrativo de auditor para ejecutar este mandato.

Objeto de destino

Ninguno.

Parámetros necesarios

-notificationRef
Especifica el ID de referencia del objeto de notificación de auditoría que se va a suprimir. (String, obligatorio)

Valor de retorno

El mandato devuelve un valor de true si el sistema suprime correctamente el objeto de notificación de auditoría del archivo de configuración audit.xml.

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.deleteAuditNotification('-notificationRef WSNotification_1184690835390')
  • Utilizando la lista Jython:
    AdminTask.deleteAuditNotification(['-notificationRef', 'WSNotification_1184690835390'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.deleteAuditNotification('-interactive')

deleteAuditNotificationMonitorByName

El mandato deleteAuditNotificationMonitorByName suprime el supervisor de notificación de auditoría que especifica el usuario con el nombre exclusivo.

El usuario debe tener el rol administrativo de auditor para ejecutar este mandato.

Objeto de destino

Ninguno.

Parámetros necesarios

-monitorName
Especifica el nombre exclusivo del supervisor de notificación de auditoría que se va a suprimir. (String, obligatorio)

Valor de retorno

El mandato devuelve un valor de true si el sistema suprime correctamente el supervisor de notificación de auditoría de la configuración.

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.deleteAuditNotificationMonitor('-monitorName mymonitor')
  • Utilizando la lista Jython:
    AdminTask.deleteAuditNotificationMonitor(['-monitorName', 'mymonitor'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.deleteAuditNotificationMonitor('-interactive')

deleteAuditNotificationMonitorByRef

El mandato deleteAuditNotificationMonitorByRef suprime el supervisor de notificación de auditoría que especifica el usuario con el ID de referencia.

El usuario debe tener el rol administrativo de auditor para ejecutar este mandato.

Objeto de destino

Ninguno.

Parámetros necesarios

-monitorRef
Especifica el ID de referencia del objeto del supervisor de notificación de auditoría que se va a suprimir. (String, obligatorio)

Valor de retorno

El mandato devuelve un valor de true si el sistema suprime correctamente el supervisor de notificación de auditoría de interés.

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.deleteAuditNotificationMonitor('-monitorRef 
    AuditNotificationMonitor_1184695615171')
  • Utilizando la lista Jython:
    AdminTask.deleteAuditNotificationMonitor(['-monitorRef', 
    'AuditNotificationMonitor_1184695615171'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.deleteAuditNotificationMonitor('-interactive')

getAuditNotification

El mandato getAuditNotification recupera los atributos para un objeto de notificación de auditoría de interés.

El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.

Objeto de destino

Ninguno.

Parámetros necesarios

-notificationRef
Especifica el ID de referencia del objeto de notificación de auditoría de interés. (String, obligatorio)

Valor de retorno

El mandato devuelve una lista de atributos para el objeto de notificación de auditoría específico, tal como se indica en la salida de ejemplo siguiente:
{{name mynotification}
{sslConfig {}}
{logToSystemOut true}
{_Websphere_Config_Data_Id cells/CHEYENNENode04Cell|audit.xml#WSNotification_1184690835390}
{emailList sweetshadow@us.ibm.com(smtp-server.us.ibm.com)}
{sendEmail true}
{_Websphere_Config_Data_Type WSNotification}
{properties {}}
{emailFormat HTML}}

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.getAuditNotification('-notificationRef WSNotification_1184690835390')
  • Utilizando la lista Jython:
    AdminTask.getAuditNotification(['-notificationRef', 'WSNotification_1184690835390'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.getAuditNotification('-interactive')

getAuditNotificationMonitor

El mandato getAuditNotificationMonitor recupera los atributos que asocia el sistema con el supervisor de notificación de auditoría de interés.

El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.

Objeto de destino

Ninguno.

Parámetros necesarios

-monitorRef
Especifica el ID de referencia del supervisor de notificación de auditoría de interés. (String, obligatorio)

Valor de retorno

El mandato devuelve una lista de atributos para el supervisor de notificación de auditoría de interés, tal como se muestra en la salida de ejemplo siguiente:
{{name mymonitor}
{enabled true}
{_Websphere_Config_Data_Id cells/Node04Cell|audit.xml#AuditNotificationMonitor_1184695615171}
{_Websphere_Config_Data_Type AuditNotificationMonitor}
{wsNotification mynotification(cells/Node04Cell|audit.xml#WSNotification_1184690835390)}}

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.getAuditNotificationMonitor('-monitorRef 
    AuditNotificationMonitor_1184695615171')
  • Utilizando la lista Jython:
    AdminTask.getAuditNotificationMonitor(['-monitorRef', 
    'AuditNotificationMonitor_1184695615171'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.getAuditNotificationMonitor('-interactive')

getEmailList

El mandato getEmailList recupera la lista de distribución de correo electrónico para el objeto de notificación de auditoría. Si el supervisor de notificación no está configurado, el objeto de notificación de auditoría no está activo y el mandato devuelve un valor nulo.

El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.

Objeto de destino

Ninguno.

Valor de retorno

El mandato devuelve esta lista de correo electrónico para el objeto de notificación de auditoría activo, tal como se indica en la salida de ejemplo siguiente:
admin@mycompany.com(smtp-server.mycompany.com)

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.getEmailList()
  • Utilizando la lista Jython:
    AdminTask.getEmailList()

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.getEmailList('-interactive')

getSendEmail

El mandato getSendEmail muestra si el objeto de notificación de auditoría envía o no un correo electrónico si el subsistema de auditoría falla. Si el supervisor de notificación no está configurado, el objeto de notificación de auditoría no está activo y el mandato devuelve un valor nulo.

El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.

Objeto de destino

Ninguno.

Valor de retorno

El mandato devuelve un valor de true si el sistema está configurado para enviar un correo electrónico a la lista de distribución.

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.getSendEmail()
  • Utilizando la lista Jython:
    AdminTask.getSendEmail()

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.getSendEmail('-interactive')

getAuditNotificationRef

El mandato getAuditNotificationRef recupera el ID de referencia para el objeto de notificación de auditoría activo. Si el supervisor de notificación no está configurado, el objeto de notificación de auditoría no está activo y el mandato devuelve un valor nulo.

El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.

Objeto de destino

Ninguno.

Valor de retorno

El mandato devuelve el ID de referencia del objeto de notificación de auditoría si está activo, tal como se muestra en la salida de ejemplo siguiente:
WSNotification_1184690835390

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.getAuditNotificationRef()
  • Utilizando la lista Jython:
    AdminTask.getAuditNotificationRef()

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.getAuditNotificationRef('-interactive')

getAuditNotificationName

El mandato getAuditNotificationName recupera el nombre exclusivo para el objeto de notificación de auditoría activo. Si el supervisor de notificación no está configurado, el objeto de notificación de auditoría no está activo y el mandato devuelve un valor nulo.

El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.

Objeto de destino

Ninguno.

Valor de retorno

El mandato devuelve el nombre exclusivo del objeto de notificación de auditoría, tal como se muestra en la salida de ejemplo siguiente:
mynotification

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.getAuditNotificationName()
  • Utilizando la lista Jython:
    AdminTask.getAuditNotificationName()

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.getAuditNotificationName('-interactive')

isSendEmailEnabled

El mandato isSendEmailEnabled determina si el sistema se ha configurado para enviar un correo electrónico, si el subsistema de auditoría de seguridad falla.

El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.

Objeto de destino

Ninguno.

Valor de retorno

El mandato devuelve un valor de true si el correo electrónico está habilitado.

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.isSendEmailEnabled()
  • Utilizando la lista Jython:
    AdminTask.isSendEmailEnabled()

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.isSendEmailEnabled('-interactive')

isAuditNotificationEnabled

El mandato isAuditNotificationEnabled determina si están habilitadas las notificaciones del sistema de auditoría de auditoría.

El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.

Objeto de destino

Ninguno.

Valor de retorno

El mandato devuelve un valor de true si las notificaciones del sistema de auditoría de seguridad están habilitadas.

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.isAuditNotificationEnabled()
  • Utilizando la lista Jython:
    AdminTask.isAuditNotificationEnabled()

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.isAuditNotificationEnabled()

listAuditNotifications

El mandato listAuditNotifications recupera los atributos para cada objeto de notificación de auditoría que se haya configurado en el archivo audit.xml.

El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.

Objeto de destino

Ninguno.

Valor de retorno

El mandato devuelve una lista de los atributos para cada objeto de notificación de auditoría configurado, tal como se indica en la salida de ejemplo siguiente:
{{name mynotification}
{sslConfig {}}
{logToSystemOut true}
{_Websphere_Config_Data_Id cells/CHEYENNENode04Cell|audit.xml#WSNotification_1184690835390}
{emailList sweetshadow@us.ibm.com(smtp-server.us.ibm.com)}
{sendEmail true}
{notificationRef WSNotification_1184690835390}
{_Websphere_Config_Data_Type WSNotification}
{properties {}}
{emailFormat HTML}}

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.listAuditNotifications()
  • Utilizando la lista Jython:
    AdminTask.listAuditNotifications()

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.listAuditNotifications('-interactive')

listAuditNotificationMonitors

El mandato listAuditNotificationMonitors lista los atributos del supervisor de notificación de auditoría que está configurado en el archivo audit.xml .

El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.

Objeto de destino

Ninguno.

Valor de retorno

El mandato devuelve una lista de los atributos para el supervisor de notificación de auditoría, tal como se indica en la salida de ejemplo siguiente:
{{name mymonitor}
{enabled true}
{_Websphere_Config_Data_Id cells/Node04Cell|audit.xml#AuditNotificationMonitor_1184695615171}
{_Websphere_Config_Data_Type AuditNotificationMonitor}
{monitorRef AuditNotificationMonitor_1184695615171}
{wsNotification mynotification(cells/Node04Cell|audit.xml#WSNotification_1184690835390)}
{notificationRef WSNotification_1184690835390}}

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.listAuditNotificationMonitors()
  • Utilizando la lista Jython:
    AdminTask.listAuditNotificationMonitors()

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.listAuditNotificationMonitors('-interactive'b)

modifyAuditNotification

El mandato modifyAuditNotification edita el objeto de notificación de auditoría en el archivo de configuración audit.xml.

El usuario debe tener el rol administrativo de auditor para ejecutar este mandato.

Objeto de destino

Ninguno.

Parámetros necesarios

-notificationRef
Especifica el ID de referencia del objeto de notificación de auditoría que se va a editar. (String, obligatorio)

Parámetros opcionales

-logToSystemOut
Especifica si se van a anotar cronológicamente las notificaciones en el archivo SystemOut.log . (Boolean, opcional)
-sendEmail
Especifica si se van a enviar notificaciones de correo electrónico. (Boolean, opcional)
-emailList
Especifica la dirección de correo electrónico de la lista de distribución adonde el sistema envía las notificaciones de correo electrónico. (String, opcional)
-emailFormat
Especifica el formato del correo electrónico. Especifique HTML para el formato HTML o TEXT para el formato del texto. (String, opcional)

Valor de retorno

El mandato devuelve un valor de true si el sistema actualiza correctamente la configuración del sistema de auditoría de seguridad.

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.modifyAuditNotification('-notificationRef WSNotification_1184690835390 
    -logToSystemOut false -sendEmail true -emailList admin@mycompany.com(smtp-server.mycompany.com) 
    -emailFormat TEXT')
  • Utilizando la lista Jython:
    AdminTask.modifyAuditNotification(['-notificationRef', 'WSNotification_1184690835390', 
    '-logToSystemOut', 'false', '-sendEmail', 'true', '-emailList', 
    'admin@mycompany.com(smtp-server.mycompany.com)', '-emailFormat', 'TEXT'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.modifyAuditNotification('-interactive')

modifyAuditNotificationMonitor

El mandato modifyAuditNotificationMonitor edita la configuración del supervisor de notificación de auditoría para el sistema de auditoría de seguridad.

El usuario debe tener el rol administrativo de auditor para ejecutar este mandato.

Objeto de destino

Ninguno.

Parámetros necesarios

-monitorRef
Especifica el ID de referencia del supervisor de notificación de auditoría de interés. (String, obligatorio)

Parámetros opcionales

-notificationRef
Especifica el ID de referencia del objeto de notificación de auditoría. (String, opcional)
-enable
Especifica si se va a habilitar el supervisor de notificación de auditoría. (Boolean, opcional)

Valor de retorno

El mandato devuelve un valor de true si el sistema actualiza correctamente la configuración del supervisor de notificación de auditoría.

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.modifyAuditNotificationMonitor('-monitorRef AuditNotificationMonitor_1184695615171 
    -notificationRef WSNotification_1184690835390 -enable true')
  • Utilizando la lista Jython:
    AdminTask.modifyAuditNotificationMonitor(['-monitorRef', 'AuditNotificationMonitor_1184695615171', 
    '-notificationRef', 'WSNotification_1184690835390', '-enable', 'true'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.modifyAuditNotificationMonitor('-interactive')

setEmailList

El mandato setEmailList especifica la lista de distribución a la que enviar las notificaciones de correo electrónico, si el subsistema de auditoría de seguridad falla.

El usuario debe tener el rol administrativo de auditor para ejecutar este mandato.

Objeto de destino

Ninguno.

Parámetros necesarios

-emailList
Especifica la dirección de correo electrónico o la lista de distribución de correo electrónico a la que se van enviar las notificaciones de auditoría. (String, obligatorio)

Valor de retorno

El mandato devuelve un valor de true si el sistema establece correctamente la lista de notificación de correo electrónico para el objeto de notificación.

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.setEmailList('[-emailList admin@mycompany.com(smtp-server.mycompany.com)]')
  • Utilizando la lista Jython:
    AdminTask.setEmailList(['-emailList', 'admin@mycompany.com(smtp-server.mycompany.com)'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando la serie Jython:
    AdminTask.setEmailList('-interactive')

setSendEmail

El mandato setSendEmail habilita o inhabilita las notificaciones de correo electrónico para el sistema de auditoría de seguridad.

El usuario debe tener el rol administrativo de auditor para ejecutar este mandato.

Objeto de destino

Ninguno.

Parámetros necesarios

-enable
Especifica si se va a habilitar el sistema para enviar notificaciones de correo electrónico a través del correo electrónico. (Boolean, necesario)

Valor de retorno

El mandato devuelve un valor de true si el sistema modifica correctamente la configuración.

Uso del ejemplo de modalidad de proceso por lotes

  • Utilizando la serie Jython:
    AdminTask.setSendEmail('-enable true')
  • Utilizando la lista Jython:
    AdminTask.setSendEmail(['-enable', 'true'])

Ejemplo de utilización de la modalidad interactiva

  • Utilizando Jython:
    AdminTask.setSendEmail('-interactive')

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7audit7
File name: rxml_7audit7.html