×

IDMWORKS Blog

Using Enterprise Manager to Debug Event Handlers in OIM 11gR2


I was introduced to this method of investigating Event Handlers using Enterprise Manager by a colleague.  The only other time I’ve seen it referenced was a quick reference in some of the OIM Developer documentation.  I’ve found this useful when beginning the Event Handler debug process.

The basic premise of this method is to utilize Enterprise Manager to handle querying the MBean for the User and Operation.  I’ll walk you through how to access the functionality (the screenshots are 11gR2 PS2 but the steps are applicable to any version of OIM 11gR2).  Open the Enterprise Manager that is associated with the Admin Server for your OIM domain.

In the tree view on the left, open Identity and Access  -> OIM and click on oim(11.1.2.0.0).  In the Oracle Identity Manager drop-down list near the center of the screen, select System MBean Browser.  For clusters, open Identity and Access  -> OIM and click on any of the entries that say oim(11.1.2.0.0).

The MBean Browser will open.  There are three root folders: Configuration MBeans, Runtime MBeans, and Application Defined MBeans.  We are concerned with the Application Defined MBeans folder so feel free to close the first two.

From here we will browse to: Application Defined MBean -> oracle.iam -> Server: (oim node) -> Application: oim -> IAMAppDesignMBean -> ConfigQueryMBeanName.  For clusters, you can just select the first node.  OIM replicates these changes across all of the nodes so the results will be the same.

(Note the screenshots also show OperationConfigMXBean but this may MBean not be present depending on the version of OIM that you are running this command upon.)

You will then select the Operations tab.  There is one Operation, getEventHandlers, click it.

b2ap3_thumbnail_getEventHandlers1.png

 

You will need to enter two parameters, p1 and p2.  p1 defines which entity you want to run the Operation on, and p2 defines the Entity Operation for which you want to see Event Handlers.

In our case, p1 will be “user” and p2 will be “create”.

 

 

b2ap3_thumbnail_getEventHandlers2.png

 

When those are entered, click Invoke and the Operation will be performed and results will be displayed below.

b2ap3_thumbnail_getEventHandlers3.png

 

(Each line has the format: Stage,Order,Name,Location,Conditional)

 

You can find documentation of this Operation at: http://docs.oracle.com/cd/E27559_01/dev.1112/e27150/oper.htm#BGBHJDCI

The following entities and operations are ones that are either listed in the documentation or that I’ve discovered to produce valid results.  The parameters are NOT case-sensitive.

Entities (p1): User, Role, RoleUser, Organization, Rule

Operations (p2): create, modify, delete

 

Here is the generic output of a fresh instance:

Questions, comments or concerns? Feel free to reach out to us below, or email us at IDMWORKS to learn more about how you can protect your organization and customers.

Questions, comments or concerns? Feel free to reach out to us below, or email us at IDMWORKS to learn more about how you can protect your organization and customers.

Comments on: “Using Enterprise Manager to Debug Event Handlers in OIM 11gR2”

    1. Florence, for the above the p1 parameter is ‘user’ and p2 parameter is ‘create’. But, for this, you could do any event / type based on the scope of the event handlers you are looking to audit.

Leave a Reply

Your email address will not be published. Required fields are marked *