oig 11g r2 field enablement training · email: test1.test1 @oracle.com 5.4. organization:...

OIG 11G R2 Training

Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 1 | P a g e

OIG 11G R2 Field Enablement Training

Lab 20 - Notification Lab

Disclaimer: The Virtual Machine Image and other software are provided for use only

during the workshop. Please note that you are responsible for deleting them from your

computers before you leave. If you would like to try out any of the Oracle products, you

may download them from the Oracle Technology Network

(http://www.oracle.com/technology/index.html) or the Oracle E-Delivery WebSite

(http://edelivery.oracle.com)

http://www.oracle.com/technology/index.html

http://edelivery.oracle.com/

OIG 11G R2 Training


Table of Contents

OIG 11G R2 Field Enablement Training ......................................................................................................... 1

Notification Lab ......................................................................................................................................... 1

1. Introduction .......................................................................................................................................... 3

2 Deploying the required Plug-in .............................................................................................................. 4

2.1 Description of Package .................................................................................................................... 4

2.2 Deployment Procedure ................................................................................................................... 8

2.3 Verify Plugin Entries and Event Handler Registration ..................................................................... 8

2.4 Verify SOA MDS Repository for Event Handler Definition .............................................................. 9

3 Configuring UMS .................................................................................................................................. 11

4. Time to send email! ........................................................................................................................ 17

4.1 Test Email Notification during User Creation ............................................................................... 17

4.2 Test Email Notification during Role Assignment ........................................................................... 18

OIG 11G R2 Training


1. Introduction

OIG 11G R2 Training


2 Deploying the required Plug-in

This step includes the configuration required before running the Bulk Load utility.

2.1 Description of Package

1. Open the package Notification - Role_Grant - PS1(/app/dummydata/Lab 20)

Folder Structure Description

PROJECT-CONTEXT]/config

Contains the event handler definitions file Includes all .xml files including plugin.xml file. Except plugin.xml all other files will be chosen to be imported in Oracle MDS.

[PROJECT-CONTEXT]/resources

Includes all the required resources files. e.g.; text files, properties files, images, etc.

[PROJECT-CONTEXT]/lib

Includes all the required jar files. The project JAR file is as well creat-ed in this same folder.

[PROJECT-CONTEXT]/src

This includes the source files for ora-cle.iam.sample.notification.RoleGrantNotificationEvent.java What for this class Is used? ora-cle.iam.sample.notification.RoleGrantNotificationEventResolver.java What for this class Is used?

[PROJECT-CON-TEXT]/importfiles

The files which are required to be imported in OIM to make this event handler execute properly should be placed in this folder.

[PROJECT-CONTEXT]/ Notifica-tion - Role_Grant - PS1.jpr

Project Package which can be open in JDeveloper.

2. Open “Startup_Scripts” folder on Desktop, Click launchJDEV.sh .

OIG 11G R2 Training


3. In the Jdeveloper window from the File menu, click on Open.

4. Navigate to the “/app/dummydata/Lab 20/Notification - Role_Grant - PS1” folder.

5. Select the Notification – Role_Grant – PS1.jpr.

6. Click on Open.

7. Click OK in the confirmation dialog box.

8. Notice that the project is opened and shown in one of the frames.

9. In the Projects frame, right click on the project and select Project Properties.

Note: Minimum required JAR files: Once the project package is opened in the JDeveloper it is re-

quired that the minimum required JAR files be added in the project classpath. Not doing so will

cause the compilation process to fail and hence the plugin won’t be deployed to OIM. So please

make sure you have these JAR files (and any other required JAR files) added to the project

classpath. We are going to set these now.

OIG 11G R2 Training


10. In the Properties window click on Libraries and Classpath.

11. In the right pane, click on oimclient.jar.

12. Click on Remove.

13. In the right pane click on OIMServer.jar.

14. Click on Remove.

15. Click on Add Jar/Directory.

16. Navigate to the below directory.

16.1. /app/Middleware/Oracle_IDM1/server/client/

17. Select oimclient.jar and click on Select.

OIG 11G R2 Training


18. Click on Add Jar/Directory.

19. Navigate to the below directory.

19.1. /app/Middleware/Oracle_IDM1/server/apps/oim.ear/APP-INF/lib/

20. Select OIMServer.jar and click on Select.

OIG 11G R2 Training


21. Click on OK to close the Project Properties window.

2.2 Deployment Procedure

1. Make sure the project is select in the Projects pane.

2. Navigate to Tools OIM customization installer.

3. Click on Deploy.

4. On a successful deployment a success dialog will be shown.

2.3 Verify Plugin Entries and Event Handler Registration

1. Open the plugin.xml file under [PROJECT-CONTEXT]/config folder.

2. There are 2 entries as shown. We shall try to see if the same have been populated in OIM DB or

not.

OIG 11G R2 Training


3. Let’s check Plugin table in OIM DB. Use the below commands.

4. There should be 2 entries as shown.

2.4 Verify SOA MDS Repository for Event Handler Definition

Event handler definition files EventHandlers-UserRoleNotification.xml and

RoleGrantNotificationEvent.xml under PROJECT-CONTEXT]/config should be seen under SOA-MDS Con-

nection highlighted in Red.

# sqlplus # Enter User Name: DEV_OIM # Enter Password: Oracle123 # select ID from plugins;

OIG 11G R2 Training


OIG 11G R2 Training


3 Configuring UMS

In PS2, UMS is a recommended way to send Notifications. Following steps are required to use UMS in

OIM.

Note: for this exercise the following items need to be turned on.

DB

Admin server

OIM Managed server

SOA Managed server

1. Hit the Enterprise Manager (EM) console in a new browser window.

2. Login as weblogic.

3. Navigate to Application Deployments OIMAppMetadata(11.1.1.3.0)(oim_server1).

4. Right click on OIMAppMetadata and select System MBean Browser.

OIG 11G R2 Training


5. In the MBean browser go to Application Defined MBeans oracle.iam Server: oim_server1.

OIG 11G R2 Training


6. Expand Application: oim.

7. Navigate to IAMAppRuntimeMBean UMSEmailNotificationProviderMBean.

OIG 11G R2 Training


8. Look at the properties configured for the bean. The web services URL needs to point to

http://identity.oracleads.com:8001/ucs/messaging/webservice.

9. Let us configure the email driver properties. This is required if you would wish to your own cus-

tom email server for sending emails. In a client environment you might to want to provide the

details of their email solution.

10. In the left hand side frame, under Farm_iam_domain, navigate to usermessagingdriver-email

(soa_server1).

OIG 11G R2 Training


11. In the right hand side frame click on the User Messaging Email Driver menu.

12. Select Email Driver Properties.

13. Scroll down through the Driver-Specific Configuration section.

14. You may notice that all the required properties of the JES on the VM are set. You may change

them accordingly to another environment/solution.

OIG 11G R2 Training


OIG 11G R2 Training


4. Time to send email!

4.1 Test Email Notification during User Creation

This section describes the procedure for testing the Generated Password Notification template customi-

zation. Use the following steps to test the customization.

1. Hit the Identity console in a new browser window.

2. Login as ADMIN.

3. Navigate to Users under the Administration menu.

4. Click on Create.

5. Create a user with the below information.

5.1. First Name: test1

5.2. Last Name: test1

5.3. Email: test1.test1 @oracle.com

5.4. Organization: Information Systems

5.5. Employee Type: Full Time Employee

5.6.

Note: do not provide the user login and password details. They shall be sent in the email.

6. Click on Save.

7. In the VM, open the Thunderbird client.

mailto:[email protected]

OIG 11G R2 Training


4.2 Test Email Notification during Role Assignment

1. Open and login to the Identity console if not already open.

2. Navigate to Users under Administration menu.

3. Search for the user with User Login as DCRANE.

4. Select the row with DCRANE as user login. Do no open.

5. Upon selection the menu above refreshes to have more options.

6. Click on Reset Password.

7. Leave the settings as is and hit Reset Password button.

OIG 11G R2 Training


8. A confirmation message appears at the top.

9. Open the Thunderbird client in the VM.

10. Navigate to the [email protected] Inbox.

11. A notification email appears with the newly generated password.

mailto:[email protected]

oig 11g r2 field enablement training · email: test1.test1 @oracle.com 5.4. organization:...

Documents