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
{{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
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
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
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
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
{{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')