Page History

Included in the downloaded ZIP file is an example of how you can create a Windows user authentication service. This is particularly useful if you would like to provide a single sign-on facility on your IBM i.

Browse the downloaded .NET source code using Windows Explorer.Image Removed

 Image Added 

Go into the App_Code folder (the App_Code folder is a special folder where all your source code should reside in – files in this folder will be automatically compiled by the .NET runtime). You should see a C# source file called WindowsUserSservices WindowsUserServices.

Image Removed Image Added 

Open that file using any text editor, and you can see the core code that does the user authentication.

Now go back to Windows Explorer, and go into the Controllers sub-directory.Image Removed

 Image Added 

Now go back to Windows Explorer, and go into the Controllers sub-directory.

You should see the a file called UserController.cs. A controller publishes your service as a web service.Image Removed

 Image Added 

Notice the annotations RoutePrefix and Route. They indicate the URL path you would use to invoke the services in this controller.Image Removed

 Image Added 

For example, to invoke the AuthenticateUser service, you would use the following URL (adjust the port number to the port you put when you created the web app in IIS):

       http://localhost:9001/user/authenticate^{Image Removed}

Let's now test this service using a web browser.

Pick a local or domain username & password (preferably a test username & password) that you are going to use in this test.

If you are using your real account, until we have setup HTTPS, do not specify your real password (just specify an incorrect password – which is enough for the purpose of this testing).

Open your web browser and navigate to the following URL:

       http://localhost:9001/user/authenticate?domain=domain&user=username&password=password^{Image Removed}

For example:

       httphttp://localhost:9001/user/authenticate?domain=SYD&user=tony&password=mysecretpwd^{Image Removed}

You should see the following response if your password was incorrect:Image Removed

 Image Added 

Next: Writing your RDMLX Base Class for Your Windows Services