AuditEventFactoryCommands para el objeto AdminTask
Puede utilizar el lenguaje de script Jython para configurar el sistema de auditoría de seguridad con la herramienta wsadmin. Utilice los mandatos y parámetros del grupo AuditEventFactoryCommands para configurar la fábrica de sucesos de auditoría por omisión o de otro proveedor.
createAuditEventFactory
El mandato createAuditEventFactory crea una fábrica de sucesos de auditoría en la configuración del sistema de auditoría de seguridad. Puede utilizar la implementación de la fábrica de sucesos predeterminada o una implementación de terceros. Para configurar una implementación de terceros, utilice el parámetro -customProperties opcional para especificar las propiedades necesarias para configurar la implementación de la fábrica de sucesos de auditoría.
El usuario debe tener el rol administrativo de auditor para ejecutar este mandato.
Objeto de destino
Ninguno.
Parámetros necesarios
- -uniqueName
- Especifica un nombre exclusivo que identifica la fábrica de sucesos de auditoría. (String, obligatorio)
- -className
- Especifica la implementación de clase de la interfaz de la fábrica de sucesos de auditoría. (String, obligatorio)
- -provider
- Especifica una referencia a una implementación de proveedor de servicios de auditoría predefinida. (String, obligatorio)
- -auditFilters
- Especifica una referencia o un grupo de referencias a filtros de auditoría predefinidos, utilizando el formato siguiente: referencia, referencia, referencia (String, obligatorio)
Parámetros opcionales
- -customProperties
- Especifica cualquier propiedad personalizada necesaria para configurar una implementación de otro proveedor. (String, opcional)
Valor de retorno
El mandato devuelve el ID de referencia abreviado para la fábrica de sucesos de auditoría acabada de crear.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.createAuditEventFactory('-uniqueName myeventfactory -className com.mycompany.myeventfactoryclass -provider AuditServiceProvider_1173199825608 -customProperties a=b -auditFilters AuditSpecification_1184598886859')
- Utilizando la lista Jython:
AdminTask.createAuditEventFactory(['-uniqueName', 'myeventfactory', '-className', 'com.mycompany.myeventfactoryclass', '-provider', 'AuditServiceProvider_1173199825608', '-customProperties', 'a=b', '-auditFilters', 'AuditSpecification_1184598886859'])
Ejemplo de utilización de la modalidad interactiva
- Utilizando Jython:
AdminTask.createAuditEventFactory()
deleteAuditEventFactoryByName
El mandato deleteAuditEventFactoryByName suprime la implementación de la fábrica de sucesos de auditoría en el archivo audit.xml que coincide con un identificador de nombre exclusivo específico.
El usuario debe tener el rol administrativo de auditor para ejecutar este mandato.
Objeto de destino
Ninguno.
Parámetros necesarios
- -uniqueName
- Especifica el nombre exclusivo de la implementación de la fábrica de sucesos de auditoría. (String, obligatorio)
Valor de retorno
El mandato devuelve un valor de true si el sistema suprime correctamente la fábrica de sucesos de auditoría.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.deleteAuditEventFactoryByName('–uniqueName myeventfactory')
- Utilizando la lista Jython:
AdminTask.deleteAuditEventFactoryByName(['–uniqueName', 'myeventfactory'])
Ejemplo de utilización de la modalidad interactiva
- Utilizando Jython:
AdminTask.deleteAuditEventFactoryByName('-interactive')
deleteAuditEventFactoryByRef
El mandato deleteAuditEventFactoryByRef suprime la implementación de la fábrica de sucesos de auditoría que coincide con el ID de referencia de interés.
El usuario debe tener el rol administrativo de auditor para ejecutar este mandato.
Objeto de destino
Ninguno.
Parámetros necesarios
- -eventFactoryRef
- Especifica una implementación de fábrica de sucesos de auditoría. Este parámetro puede ser una referencia al objeto de la fábrica de sucesos. (String, obligatorio)
Valor de retorno
El mandato devuelve un valor de true si el sistema suprime correctamente la fábrica de sucesos de auditoría.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.deleteAuditEventFactoryByRef('–eventFactoryRef AuditEventFactory_1184688293515')
- Utilizando la lista Jython:
AdminTask.deleteAuditEventFactoryByRef(['–eventFactoryRef', 'AuditEventFactory_1184688293515'])
Ejemplo de utilización de la modalidad interactiva
- Utilizando Jython:
AdminTask.deleteAuditEventFactoryByRef('–interactive')
getAuditEventFactory
El mandato getAuditEventFactory recupera la lista de atributos para la implementación de la fábrica de sucesos de auditoría en el archivo audit.xml para un ID de referencia específico.
El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.
Objeto de destino
Ninguno.
Parámetros necesarios
- -eventFactoryRef
- Especifica una implementación de fábrica de sucesos de auditoría. Este parámetro puede ser una referencia al objeto de la fábrica de sucesos. (String, obligatorio)
Valor de retorno
{{name myeventfactory}
{properties {{{validationExpression {}}
{name a}
{description {}}
{value b}
{_Websphere_Config_Data_Id cells/Node04Cell|audit.xml#Property_1184688593531}
{_Websphere_Config_Data_Type Property}
{required false}}}}
{className com.mycompany.myeventfactoryclass}
{auditServiceProvider auditServiceProviderImpl_1(cells/Node04Cell|audit.xml#AuditServiceProvider_1173199825608)}
{auditSpecifications DefaultAuditSpecification_1(cells/Node04Cell|audit.xml#AuditSpecification_1173199825608)}
{_Websphere_Config_Data_Id cells/Node04Cell|audit.xml#AuditEventFactory_1184688293515}
{_Websphere_Config_Data_Type AuditEventFactory}}
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.getAuditEventFactory('-eventFactoryRef AuditEventFactory_1184688293515')
- Utilizando la lista Jython:
AdminTask.getAuditEventFactory(['-eventFactoryRef', 'AuditEventFactory_1184688293515'])
Ejemplo de utilización de la modalidad interactiva
- Utilizando Jython:
AdminTask.getAuditEventFactory('-interactive')
getAuditEventFactoryClass
El mandato getAuditEventFactoryClass recupera el nombre de la clase de la implementación de la fábrica de sucesos de auditoría que coincide con un ID de referencia específico en el archivo de configuración audit.xml.
El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.
Objeto de destino
Ninguno.
Parámetros necesarios
- -eventFactoryRef
- Especifica una implementación de fábrica de sucesos de auditoría. Este parámetro puede ser una referencia al objeto de la fábrica de sucesos. (String, obligatorio)
Valor de retorno
com.mycompany.myeventfactoryclass
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.getAuditEventFactoryClass('-eventFactoryRef AuditEventFactory_1184688293515')
- Utilizando la lista Jython:
AdminTask.getAuditEventFactoryClass(['-eventFactoryRef', 'AuditEventFactory_1184688293515'])
Ejemplo de utilización de la modalidad interactiva
- Utilizando Jython:
AdminTask.getAuditEventFactoryClass('-interactive')
getAuditEventFactoryFilters
El mandato getAuditEventFactoryFilters recupera una lista de filtros pasados para la fábrica de sucesos transferida.
El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.
Objeto de destino
Ninguno.
Parámetros necesarios
- -eventFactoryRef
- Especifica una implementación de fábrica de sucesos de auditoría. Este parámetro puede ser una referencia al objeto de la fábrica de sucesos. (String, obligatorio)
Valor de retorno
AUTHN:SUCCESS,AUTHN:INFO,AUTHZ:SUCCESS,AUTHZ:INFO
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.getAuditEventFactoryFilters('-eventFactoryRef AuditEventFactory_1184688293515')
- Utilizando la lista Jython:
AdminTask.getAuditEventFactoryFilters(['-eventFactoryRef', 'AuditEventFactory_1184688293515'])
Ejemplo de utilización de la modalidad interactiva
- Utilizando Jython:
AdminTask.getAuditEventFactoryFilters('-interactive')
getAuditEventFactoryName
El mandato getAuditEventFactoryName recupera el nombre exclusivo de la implementación de la fábrica de sucesos de auditoría que coincide con un ID de referencia específico en el archivo de configuración audit.xml.
El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.
Objeto de destino
Ninguno.
Parámetros necesarios
- -eventFactoryRef
- Especifica una implementación de fábrica de sucesos de auditoría. Este parámetro puede ser una referencia al objeto de la fábrica de sucesos. (String, obligatorio)
Valor de retorno
myeventfactory
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.getAuditEventFactoryName('-eventFactoryRef AuditEventFactory_1184688293515')
- Utilizando la lista Jython:
AdminTask.getAuditEventFactoryName(['-eventFactoryRef', 'AuditEventFactory_1184688293515'])
Ejemplo de utilización de la modalidad interactiva
- Utilizando Jython:
AdminTask.getAuditEventFactoryName('-interactive')
getAuditEventFactoryProvider
El mandato getAuditEventFactoryProvider recupera el nombre de objeto del proveedor de servicios de auditoría que utiliza una implementación de fábrica de sucesos de auditoría específica en el archivo de configuración audit.xml .
El usuario debe tener el rol administrativo de supervisor para ejecutar este mandato.
Objeto de destino
Ninguno.
Parámetros necesarios
- -eventFactoryRef
- Especifica una implementación de fábrica de sucesos de auditoría. Este parámetro puede ser una referencia al objeto de la fábrica de sucesos. (String, obligatorio)
Valor de retorno
auditServiceProviderImpl_1(cells/Node04Cell|audit.xml#AuditServiceProvider_1173199825608)
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.getAuditEventFactoryProvider('-eventFactoryRef AuditEventFactory_1184688293515')
- Utilizando la lista Jython:
AdminTask.getAuditEventFactoryProvider(['-eventFactoryRef', 'AuditEventFactory_1184688293515'])
Ejemplo de utilización de la modalidad interactiva
- Utilizando Jython:
AdminTask.getAuditEventFactoryProvider('-interactive')
listAuditEventFactories
El mandato listAuditEventFactories recupera una lista de objetos de la fábrica de sucesos de auditoría y sus atributos que están definidos 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
{{auditSpecifications DefaultAuditSpecification_1(cells/Node04Cell|audit.xml#AuditSpecification_1173199825608)
DefaultAuditSpecification_2(cells/Node04Cell|audit.xml#AuditSpecification_1173199825609)
DefaultAuditSpecification_3(cells/Node04Cell|audit.xml#AuditSpecification_1173199825610)
DefaultAuditSpecification_4(cells/Node04Cell|audit.xml#AuditSpecification_1173199825611)}
{name auditEventFactoryImpl_1}
{_Websphere_Config_Data_Id cells/Node04Cell|audit.xml#AuditEventFactory_1173199825608}
{_Websphere_Config_Data_Type AuditEventFactory}
{auditSpecRef4 AuditSpecification_1173199825611}
{properties {}}
{auditSpecRef3 AuditSpecification_1173199825610}
{className com.ibm.ws.security.audit.AuditEventFactoryImpl}
{auditServiceProvider auditServiceProviderImpl_1(cells/Node04Cell|audit.xml#AuditServiceProvider_1173199825608)}
{auditSpecRef2 AuditSpecification_1173199825609}
{auditSpecRef1 AuditSpecification_1173199825608}
{auditEventFactoryRef AuditEventFactory_1173199825608}
{emitterRef AuditServiceProvider_1173199825608}}
{{auditSpecifications myfilter(cells/Node04Cell|audit.xml#AuditSpecification_1184598886859)}
{name myeventfactory}
{_Websphere_Config_Data_Id cells/Node04Cell|audit.xml#AuditEventFactory_1184688293515}
{_Websphere_Config_Data_Type AuditEventFactory}
{className com.mycompany.myeventfactoryclass}
{auditServiceProvider auditServiceProviderImpl_1(cells/Node04Cell|audit.xml#AuditServiceProvider_1173199825608)}
{properties {{{validationExpression {}}
{name a}
{description {}}
{value b}
{_Websphere_Config_Data_Id cells/Node04Cell|audit.xml#Property_1184688293546}
{_Websphere_Config_Data_Type Property}
{required false}}}}
{auditSpecRef1 AuditSpecification_1184598886859}
{auditEventFactoryRef AuditEventFactory_1184688293515}
{emitterRef AuditServiceProvider_1173199825608}}
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.listAuditEventFactories()
- Utilizando la lista Jython:
AdminTask.listAuditEventFactories()
Ejemplo de utilización de la modalidad interactiva
- Utilizando la serie Jython:
AdminTask.listAuditEventFactories('-interactive')
modifyAuditEventFactory
El mandato modifyAuditEventFactory modifica los atributos de la implementación de la fábrica de sucesos de auditoría al que hace referencia el mandato 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
- -eventFactoryRef
- Especifica una implementación de fábrica de sucesos de auditoría. Este parámetro puede ser una referencia al objeto de la fábrica de sucesos. (String, obligatorio)
Parámetros opcionales
- -provider
- Especifica el ID de referencia de una implementación de proveedor de servicios de auditoría. (String, opcional)
- -className
- Especifica el nombre de la clase que implementa la interfaz de la fábrica de sucesos de auditoría. (String, opcional)
- -customProperties
- Especifica una o más propiedades personalizadas para asociarlas con la fábrica de sucesos de auditoría de interés. Utilice el formato siguiente: valor nombre, valor nombre (String, opcional)
- -auditFilters
- Especifica una lista de referencias para los filtros de auditoría que existen en la configuración. Puede separar cada elemento de la lista con una coma (,), un punto y coma (;), o un espacio. (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.modifyAuditEventFactory('-eventFactoryRef AuditEventFactory_1184688293515 -provider AuditServiceProvider_1173199825608 -customProperties b=c')
- Utilizando la lista Jython:
AdminTask.modifyAuditEventFactory(['-eventFactoryRef', 'AuditEventFactory_1184688293515', '-provider', 'AuditServiceProvider_1173199825608', '-customProperties', 'b=c'])
Ejemplo de utilización de la modalidad interactiva
- Utilizando Jython:
AdminTask.modifyAuditEventFactory('-interactive')
setAuditEventFactoryFilters
El mandato setAuditEventFactoryFilters establece los filtros para una implementación de fábrica de sucesos de auditoría.
El usuario debe tener el rol administrativo de auditor para ejecutar este mandato.
Objeto de destino
Ninguno.
Parámetros necesarios
- -eventFactoryRef
- Especifica una implementación de fábrica de sucesos de auditoría. Este parámetro puede ser una referencia al objeto de la fábrica de sucesos. (String, obligatorio)
- -filtersRef
- Especifica una lista de referencias para filtros de auditoría definidos. (String, obligatorio)
Valor de retorno
El mandato devuelve un valor de true si el sistema establece correctamente los filtros para la fábrica de sucesos de auditoría.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando la serie Jython:
AdminTask.setAuditEventFactoryFilters('-eventFactoryRef AuditEventFactory_1184688293515 -filtersRef AuditSpecification_1173199825608')
- Utilizando la lista Jython:
AdminTask.setAuditEventFactoryFilters(['-eventFactoryRef', 'AuditEventFactory_1184688293515', '-filtersRef', 'AuditSpecification_1173199825608'])
Ejemplo de utilización de la modalidad interactiva
- Utilizando la serie Jython:
AdminTask.setAuditEventFactoryFilters('-interactive')