Groupe de commandes AuditEventFactoryCommands de l'objet AdminTask

Le langage de script Jython permet de configurer le système d'audit de sécurité à l'aide de l'outil wsadmin. Les commandes et paramètres du groupe AuditEventFactoryCommands peuvent être utilisés pour configurer la fabrique d'événements d'audit par défaut ou une fabrique d'événements d'audit tierce.

createAuditEventFactory

La commande createAuditEventFactory crée une fabrique d'événements d'audit dans la configuration de votre système d'audit de sécurité. Vous pouvez utiliser l'implémentation par défaut de la fabrique d'événements d'audit ou une implémentation tierce. Pour configurer une implémentation tierce, utilisez le paramètre facultatif -customProperties pour indiquer les propriétés nécessaires, le cas échéant.

L'utilisateur doit disposer du rôle d'administration d'auditeur pour exécuter cette commande.

Objet cible

Aucune.

Paramètres obligatoires.

-uniqueName
Indique le nom unique qui identifie la fabrique d'événements d'audit. (Chaîne, obligatoire)
-className
Indique l'implémentation de classe de l'interface de fabrique d'événements d'audit. (Chaîne, obligatoire)
-provider
Indique une référence à une implémentation de fournisseur de services d'audit prédéfinie. (Chaîne, obligatoire)
-auditFilters
Indique une référence ou un groupe de références à des filtres d'audit prédéfinis, selon le format suivant : référence, référence, référence (Chaîne, obligatoire)

Paramètres facultatifs

-customProperties
Indique les propriétés personnalisées nécessaires pour configurer une implémentation tierce. (Chaîne, facultatif)

Valeur de retour

La commande renvoie l'ID référence abrégé de la fabrique d'événements d'audit qui vient d'être créée.

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.createAuditEventFactory('-uniqueName myeventfactory -className 
    com.mycompany.myeventfactoryclass -provider AuditServiceProvider_1173199825608 
    -customProperties a=b -auditFilters AuditSpecification_1184598886859')
  • En langage Jython :
    AdminTask.createAuditEventFactory(['-uniqueName', 'myeventfactory', '-className', 
    'com.mycompany.myeventfactoryclass', '-provider', 'AuditServiceProvider_1173199825608', 
    '-customProperties', 'a=b', '-auditFilters', 'AuditSpecification_1184598886859'])

Syntaxe d'un exemple de mode interactif

  • A l'aide de Jython :
    AdminTask.createAuditEventFactory()

deleteAuditEventFactoryByName

La commande deleteAuditEventFactoryByName supprime du fichier audit.xml l'implémentation de fabrique d'événements d'audit correspondant à un nom unique déterminé.

L'utilisateur doit disposer du rôle d'administration d'auditeur pour exécuter cette commande.

Objet cible

Aucune.

Paramètres obligatoires.

-uniqueName
Indique le nom unique de l'implémentation de fabrique d'événements d'audit. (Chaîne, obligatoire)

Valeur de retour

La commande renvoie la valeur true si le système supprime correctement la fabrique d'événements d'audit.

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.deleteAuditEventFactoryByName('–uniqueName 
    myeventfactory')
  • En langage Jython :
    AdminTask.deleteAuditEventFactoryByName(['–uniqueName', 'myeventfactory'])

Syntaxe d'un exemple de mode interactif

  • A l'aide de Jython :
    AdminTask.deleteAuditEventFactoryByName('-interactive')

deleteAuditEventFactoryByRef

La commande deleteAuditEventFactoryByRef supprime l'implémentation de fabrique d'événements d'audit correspondant à l'ID référence qui vous intéresse.

L'utilisateur doit disposer du rôle d'administration d'auditeur pour exécuter cette commande.

Objet cible

Aucune.

Paramètres obligatoires.

-eventFactoryRef
Indique une implémentation de fabrique d'événements d'audit. Ce paramètre peut être une référence à l'objet de fabrique d'événements. (Chaîne, obligatoire)

Valeur de retour

La commande renvoie la valeur true si le système supprime correctement la fabrique d'événements d'audit.

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.deleteAuditEventFactoryByRef('–eventFactoryRef 
    AuditEventFactory_1184688293515')
  • En langage Jython :
    AdminTask.deleteAuditEventFactoryByRef(['–eventFactoryRef', 'AuditEventFactory_1184688293515'])

Syntaxe d'un exemple de mode interactif

  • A l'aide de Jython :
    AdminTask.deleteAuditEventFactoryByRef('–interactive')

getAuditEventFactory

La commande getAuditEventFactory extrait la liste des attributs associés à l'implémentation de fabrique d'événements d'audit correspondant à un ID référence déterminé dans le fichier audit.xml.

L'utilisateur doit disposer du rôle d'administration de moniteur pour exécuter cette commande.

Objet cible

Aucune.

Paramètres obligatoires.

-eventFactoryRef
Indique une implémentation de fabrique d'événements d'audit. Ce paramètre peut être une référence à l'objet de fabrique d'événements. (Chaîne, obligatoire)

Valeur de retour

La commande renvoie la liste des attributs associés à l'implémentation de fabrique d'événements d'audit qui vous intéresse, comme dans l'exemple de sortie suivant :
{{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}}

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.getAuditEventFactory('-eventFactoryRef AuditEventFactory_1184688293515')
  • En langage Jython :
    AdminTask.getAuditEventFactory(['-eventFactoryRef', 'AuditEventFactory_1184688293515'])

Syntaxe d'un exemple de mode interactif

  • A l'aide de Jython :
    AdminTask.getAuditEventFactory('-interactive')

getAuditEventFactoryClass

La commande getAuditEventFactoryClass extrait le nom de classe associé à l'implémentation de fabrique d'événements d'audit correspondant à un ID référence du fichier de configuration audit.xml.

L'utilisateur doit disposer du rôle d'administration de moniteur pour exécuter cette commande.

Objet cible

Aucune.

Paramètres obligatoires.

-eventFactoryRef
Indique une implémentation de fabrique d'événements d'audit. Ce paramètre peut être une référence à l'objet de fabrique d'événements. (Chaîne, obligatoire)

Valeur de retour

La commande renvoie le nom de classe associé à l'implémentation de fabrique d'événements d'audit qui vous intéresse, comme dans l'exemple de sortie suivant :
com.mycompany.myeventfactoryclass

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.getAuditEventFactoryClass('-eventFactoryRef 
    AuditEventFactory_1184688293515')
  • En langage Jython :
    AdminTask.getAuditEventFactoryClass(['-eventFactoryRef', 
    'AuditEventFactory_1184688293515'])

Syntaxe d'un exemple de mode interactif

  • A l'aide de Jython :
    AdminTask.getAuditEventFactoryClass('-interactive')

getAuditEventFactoryFilters

La commande getAuditEventFactoryFilters extrait la liste des filtres définis pour la fabrique d'événements transmise.

L'utilisateur doit disposer du rôle d'administration de moniteur pour exécuter cette commande.

Objet cible

Aucune.

Paramètres obligatoires.

-eventFactoryRef
Indique une implémentation de fabrique d'événements d'audit. Ce paramètre peut être une référence à l'objet de fabrique d'événements. (Chaîne, obligatoire)

Valeur de retour

La commande renvoie dans un format abrégé la liste des filtres définis pour la référence de fabrique d'événements qui vous intéresse, comme dans l'exemple de sortie suivant :
AUTHN:SUCCESS,AUTHN:INFO,AUTHZ:SUCCESS,AUTHZ:INFO

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.getAuditEventFactoryFilters('-eventFactoryRef 
    AuditEventFactory_1184688293515')
  • En langage Jython :
    AdminTask.getAuditEventFactoryFilters(['-eventFactoryRef', 
    'AuditEventFactory_1184688293515'])

Syntaxe d'un exemple de mode interactif

  • A l'aide de Jython :
    AdminTask.getAuditEventFactoryFilters('-interactive')

getAuditEventFactoryName

La commande getAuditEventFactoryName extrait le nom unique associé à l'implémentation de fabrique d'événements d'audit correspondant à un ID référence du fichier de configuration audit.xml.

L'utilisateur doit disposer du rôle d'administration de moniteur pour exécuter cette commande.

Objet cible

Aucune.

Paramètres obligatoires.

-eventFactoryRef
Indique une implémentation de fabrique d'événements d'audit. Ce paramètre peut être une référence à l'objet de fabrique d'événements. (Chaîne, obligatoire)

Valeur de retour

La commande renvoie le nom de l'implémentation de fabrique d'événements d'audit, comme dans l'exemple de sortie suivant :
myeventfactory

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.getAuditEventFactoryName('-eventFactoryRef 
    AuditEventFactory_1184688293515')
  • En langage Jython :
    AdminTask.getAuditEventFactoryName(['-eventFactoryRef', 
    'AuditEventFactory_1184688293515'])

Syntaxe d'un exemple de mode interactif

  • A l'aide de Jython :
    AdminTask.getAuditEventFactoryName('-interactive')

getAuditEventFactoryProvider

La commande getAuditEventFactoryProvider extrait le nom d'objet associé au fournisseur de services d'audit qu'une implémentation de fabrique d'événements d'audit déterminée utilise dans le fichier de configuration audit.xml.

L'utilisateur doit disposer du rôle d'administration de moniteur pour exécuter cette commande.

Objet cible

Aucune.

Paramètres obligatoires.

-eventFactoryRef
Indique une implémentation de fabrique d'événements d'audit. Ce paramètre peut être une référence à l'objet de fabrique d'événements. (Chaîne, obligatoire)

Valeur de retour

La commande renvoie le nom d'objet associé au fournisseur de services d'audit pour l'implémentation de fabrique d'événements d'audit qui vous intéresse, comme dans l'exemple de sortie suivant :
auditServiceProviderImpl_1(cells/Node04Cell|audit.xml#AuditServiceProvider_1173199825608)

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.getAuditEventFactoryProvider('-eventFactoryRef 
    AuditEventFactory_1184688293515')
  • En langage Jython :
    AdminTask.getAuditEventFactoryProvider(['-eventFactoryRef', 
    'AuditEventFactory_1184688293515'])

Syntaxe d'un exemple de mode interactif

  • A l'aide de Jython :
    AdminTask.getAuditEventFactoryProvider('-interactive')

listAuditEventFactories

La commande listAuditEventFactories extrait la liste des objets de fabrique d'événements d'audit définis dans le fichier audit.xml, ainsi que leurs attributs.

L'utilisateur doit disposer du rôle d'administration de moniteur pour exécuter cette commande.

Objet cible

Aucune.

Valeur de retour

La commande renvoie un tableau répertoriant les fabriques d'événements d'audit ainsi que les attributs correspondants, comme dans l'exemple de sortie suivant :
{{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}}

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.listAuditEventFactories()
  • En langage Jython :
    AdminTask.listAuditEventFactories()

Syntaxe d'un exemple de mode interactif

  • A l'aide de la chaîne Jython :
    AdminTask.listAuditEventFactories('-interactive')

modifyAuditEventFactory

La commande modifyAuditEventFactory modifie les attributs associés à l'implémentation de fabrique d'événements d'audit désignée par l'ID référence.

L'utilisateur doit disposer du rôle d'administration d'auditeur pour exécuter cette commande.

Objet cible

Aucune.

Paramètres obligatoires.

-eventFactoryRef
Indique une implémentation de fabrique d'événements d'audit. Ce paramètre peut être une référence à l'objet de fabrique d'événements. (Chaîne, obligatoire)

Paramètres facultatifs

-provider
Indique l'ID référence associé à une implémentation de fournisseur de services d'audit. (Chaîne, facultatif)
-className
Indique le nom de la classe qui implémente l'interface de fabrique d'événements d'audit. (Chaîne, facultatif)
-customProperties
Indique une ou plusieurs propriétés personnalisées à associer à la fabrique d'événements d'audit qui vous intéresse. Utilisez le format suivant : nom=valeur,nom=valeur (Chaîne, facultatif)
-auditFilters
Indique une liste de références à des filtres d'audit existant dans la configuration. Vous pouvez séparer chaque élément de la liste par une virgule (,), un point-virgule (;) ou un espace. (Chaîne, facultatif)

Valeur de retour

La commande renvoie la valeur true si le système met correctement à jour la configuration du système d'audit de sécurité.

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.modifyAuditEventFactory('-eventFactoryRef AuditEventFactory_1184688293515 -provider 
    AuditServiceProvider_1173199825608 -customProperties b=c')
  • En langage Jython :
    AdminTask.modifyAuditEventFactory(['-eventFactoryRef', 'AuditEventFactory_1184688293515', 
    '-provider', 'AuditServiceProvider_1173199825608', '-customProperties', 'b=c'])

Syntaxe d'un exemple de mode interactif

  • A l'aide de Jython :
    AdminTask.modifyAuditEventFactory('-interactive')

setAuditEventFactoryFilters

La commande setAuditEventFactoryFilters définit les filtres destinés à une implémentation de fabrique d'événements d'audit.

L'utilisateur doit disposer du rôle d'administration d'auditeur pour exécuter cette commande.

Objet cible

Aucune.

Paramètres obligatoires.

-eventFactoryRef
Indique une implémentation de fabrique d'événements d'audit. Ce paramètre peut être une référence à l'objet de fabrique d'événements. (Chaîne, obligatoire)
-filtersRef
Indique une liste de références à des filtres d'audit définis. (Chaîne, obligatoire)

Valeur de retour

La commande renvoie la valeur true si le système définit correctement les filtres destinés à la fabrique d'événements d'audit.

Exemple d'utilisation en mode de traitement par lots

  • A l'aide de la chaîne Jython :
    AdminTask.setAuditEventFactoryFilters('-eventFactoryRef AuditEventFactory_1184688293515 
    -filtersRef AuditSpecification_1173199825608')
  • En langage Jython :
    AdminTask.setAuditEventFactoryFilters(['-eventFactoryRef', 'AuditEventFactory_1184688293515', 
    '-filtersRef', 'AuditSpecification_1173199825608'])

Syntaxe d'un exemple de mode interactif

  • A l'aide de la chaîne Jython :
    AdminTask.setAuditEventFactoryFilters('-interactive')

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7audit5
Nom du fichier : rxml_7audit5.html