OIG 11G R2 Field Enablement Training

Transcription

1 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 ( or the Oracle E-Delivery WebSite ( Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 1 P a g e

2 Table of Contents OIG 11G R2 Field Enablement Training... 1 Notification Lab Introduction Deploying the required Plug-in Description of Package Deployment Procedure Verify Plugin Entries and Event Handler Registration Verify SOA MDS Repository for Event Handler Definition Configuring UMS Time to send ! Test Notification during User Creation Test Notification during Role Assignment Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 2 P a g e

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

4 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 PROJECT- CONTEXT]/config [PROJECT- CONTEXT]/resources [PROJECT- CONTEXT]/lib [PROJECT- CONTEXT]/src Description 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. Includes all the required resources files. e.g.; text files, properties files, images, etc. Includes all the required jar files. The project JAR file is as well created in this same folder. This includes the source files for oracle.iam.sample.notification.rolegrantnotificationevent.java What for this class Is used? oracle.iam.sample.notification.rolegrantnotificationeventresolver.java What for this class Is used? The files which are required to be imported in OIM to make this event handler execute properly should be placed in this folder. [PROJECT- CON- TEXT]/importfiles [PROJECT- CONTEXT]/ Notification - Role_Grant - PS1.jpr Project Package which can be open in JDeveloper. 2. Open Startup_Scripts folder on Desktop, Click launchjdev.sh. Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 4 P a g e

5 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 required 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. Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 5 P a g e

6 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 /app/middleware/oracle_idm1/server/client/ 17. Select oimclient.jar and click on Select. Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 6 P a g e

7 18. Click on Add Jar/Directory. 19. Navigate to the below directory /app/middleware/oracle_idm1/server/apps/oim.ear/app-inf/lib/ 20. Select OIMServer.jar and click on Select. Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 7 P a g e

8 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. Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 8 P a g e

9 3. Let s check Plugin table in OIM DB. Use the below commands. # sqlplus # Enter User Name: DEV_OIM # Enter Password: Oracle123 # select ID from plugins; 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 Connection highlighted in Red. Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 9 P a g e

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

11 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( )(oim_server1). 4. Right click on OIMAppMetadata and select System MBean Browser. Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 11 P a g e

12 5. In the MBean browser go to Application Defined MBeans oracle.iam Server: oim_server1. Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 12 P a g e

13 6. Expand Application: oim. 7. Navigate to IAMAppRuntimeMBean UMS NotificationProviderMBean. Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 13 P a g e

14 8. Look at the properties configured for the bean. The web services URL needs to point to 9. Let us configure the driver properties. This is required if you would wish to your own custom server for sending s. In a client environment you might to want to provide the details of their solution. 10. In the left hand side frame, under Farm_iam_domain, navigate to usermessagingdriver- (soa_server1). Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 14 P a g e

15 11. In the right hand side frame click on the User Messaging Driver menu. 12. Select 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. Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 15 P a g e

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

17 4. Time to send ! 4.1 Test Notification during User Creation This section describes the procedure for testing the Generated Password Notification template customization. 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 First Name: test Last Name: test 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 Click on Save. 7. In the VM, open the Thunderbird client. Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 17 P a g e

18 4.2 Test 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. Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 18 P a g e

19 8. A confirmation message appears at the top. 9. Open the Thunderbird client in the VM. 10. Navigate to the Danny.Crane@oracleads.com Inbox. 11. A notification appears with the newly generated password. Oracle Proprietary - Restricted to Personal Use in an Oracle partner training class 19 P a g e