This document provides instructions for getting started with OpenIDM, including downloading the binaries, installing OpenIDM, starting and stopping the service, using sample configurations, and exploring the UI functionality. It outlines how to enable self-registration and password reset in the UI configuration, and try the administrative UI. It also describes how to use the reconciliation endpoint to sync data from an XML file, and walk through a sample workflow of requesting, approving, and testing a new contractor account.

2. Overview
■
Get the OpenIDM Binaries and Install
■
Start/stop OpenIDM
■
Start OpenIDM with a sample
configuration
■
Use the OpenIDM UI
This hand-on aims to familiarize you with the OpenIDM UI and
some commonly used functionality like: create user, use selfregistration and password reset.
2

3. Some requirements…
■
JDK 1.6 update 24 or higher
■
CURL
3

4. Lets get the binaries first…
■
Latest supported release:
https://download.forgerock.com/#/openidm
ForgeRock also provides nightly builds:
http://forgerock.org/openidm.html
4

5. Installation
■
Copy the zip-archive to appropriate location
and unzip
# cp openidm-2.1.zip /opt
# unzip openidm-2.1.zip
OpenIDM
5

6. Lets start OpenIDM
$ cd /opt/openidm
$ ./startup.sh
./startup.sh
Using OPENIDM_HOME: /opt/openidm
Using OPENIDM_OPTS: -Xmx1024m
Using LOGGING_CONFIG: Djava.util.logging.config.file=/opt/openidm/conf/logging.properties
Using boot properties at /usr/local/openidm/conf/boot/boot.properties
OpenIDM version "2.1.0" (revision: 1952)
-> OpenIDM ready
6

7. Self-registration & Passwd
Reset
■
Point your browser to the OpenIDM end user dashboard:
http://localhost:8080/openidmui
■
Edit /opt/openidm/conf/ui-configuration.json and turn on:
"selfRegistration" : true,
"securityQuestions" : true,
Refresh browser!
7

8. Try out the Administrative UI
■
Point your browser to the OpenIDM end user
dashboard:
http://localhost:8080/openidmui
■
Login with user: openidm-admin and password:
openidm-admin
■
Create a user
8

9. Lets stop OpenIDM
■
To stop OpenIDM go to the terminal window
where it was started and where the Felix
console prompt should be. Stop OpenIDM with
the “shutdown command as follows:
->
-> OpenIDM ready
shutdown
->
9

10. Start with a sample…
■
$ cd /opt/openidm
■
$ ./startup.sh -p samples/workflow
./startup.sh
Using OPENIDM_HOME: /usr/local/openidm
Using OPENIDM_OPTS: -Xmx1024m
Using LOGGING_CONFIG: -Djava.util.logging.config.file=/usr/local/openidm/conf/logging.properties
Using boot properties at /opt/openidm/conf/boot/boot.properties
Using boot properties at /opt/openidm/samples/workflow/conf/boot/boot.properties
OpenIDM version "2.1.0" (revision: 1952)
->OpenIDM ready
10

11. Sample overview
XML File
11

12. Reconcile with XML-File
■
Lets study
/opt/openidm/sample/workflow/conf/sync.js
on
■
curl -u "openidm-admin:openidm-admin" -X
POST
"http://localhost:8080/openidm/recon?_acti
on=recon&mapping=systemXmlfileAccount
s_managedUser"
12

13. Request create contractor
■
Start a request to create a contractor as an employee
■
Log in to OpenIDM as a regular employee and apply for the creation of a new account for one
of your contractors.
■
Now log in to the OpenIDM UI at the URL:
http://localhost:8080/openidmui/index.html#login/
■
Use:
Login: user1
Password: Welcome1
13

14. Approval as a manager
■
Now log in to the OpenIDM UI at the URL:
http://localhost:8080/openidmui/index.html#login/
■
Use:
Login: manager1
Password: Welcome1
Assign approval to manager1 and accept the contractor!
14

15. Test the contractor..

Now log in to the OpenIDM UI at the URL:
http://localhost:8080/openidmui/index.html#login/

Use:
Login: <your selected contractor name>
Password: <your password>
15

16. Q&A
16