Tools4ever Solutions
(UMRA) - User Management Resource Administrator: Download
(ESSOM) - Enterprise Single Sign-On Manager: Download
(SSRPM) - Self Service Reset Password Management: Download

Test Environment: Server - Server 2008 R2
UMRA - 10.6 (build )

This blog is going to touch on some of the basics on how to setup a simple .asp project that will execute a UMRA project. Now, keep in mind you can still connect to UMRA using other programming methods such as .net, c# etc. However, to keep everything basic, the below example is how to connect using vbscript, in a simple .asp web page. A few questions I've been asked asked are "What can you do with a webpage or portal that connect to UMRA using it's COM object..". The simple anwser is, you can do almost all the same functions as if you were using the UMRA console. So for example, you can create a simple create user form on a web page, have the user enter in the details, then have those fields passed to a UMRA project that will create the user, add groups etc. What kind of control on the creation processes you can mange, you might ask. Well, you have full control over all aspects of the creation such as, naming algorythem, group mappings, and other downstream systems you want to manage.

*NOTE* There is an example project in the UMRA default install folder, so look in your default install directory : C:\Program Files\Tools4ever\User Management Resource Administrator\Example Projects\Automation\ASP\CreateAccount

Here is the snippet of code with some comments to better understand what is going on.You can copy/paste this into a blank .asp page. *VB SCRIPT*

'Create/Set Variables
Dim RetVal
Dim UMRA_Server
Dim UMRA_ Port
UMRA_Server = "MyServerName"
UMRA_Port = 56814
'End Create/Set Vairbales

Set Umra = Server.CreateObject("UMRAcom.Umra")
RetVal=Umra.Connect(UMRA_Server,UMRA_Port)
RetVal=Umra.ExecuteProjectScript(UMRA_Project)

When you run this script, you will see a "Return Value" if the value = 0 You were able to connect to the UMRA Server, and Run the Project you created, if you get a number other then 0, there was an error along the way. For now, this is the basics of how I connected to UMRA through the COM object.

Some other "Return Value" you might see are -5 and -1. -5 means the account that is trying to execute the UMRA form dosent have sufficent rights to run the project. You can the permissions on a UMRA from by selecting the forms properties, and clicking on the "security" tab. -1 mean either you couldnt connect to the UMRA service, or you had an error executing your UMRA project.

Now that should give you a good idea on hwo to connect to your UMRA service and execute a UMRA project through vbscript. If you have questions, please feel free to contact me or leave a comment below.