How to run LeasePak in ADFS Authentication mode
Requires ADFS Authentication module.
LeasePak Client Application
Following are the steps to login to LeasePak client application in ADFS mode:
- Create a text form of file in Notepad or a similar application that allows you to save a file in ".bat" format. For example:
"C:\Program Files (x86)\NetSol\LeasePak.NET\n.nn\LeasePak.exe" [user] [token]
Where
n.nn is LeasePak version number. For example 7.4a.
user is LeasePak shared user name.
token is LeasePak ADFS token. The value of LeasePak ADFS Token is an encrypted and base-64'd token string.
- Save this file as .bat file on your PC. There is no restriction to name it except for making it a .bat file. Users can name it as required.
- Execute the created .bat file to launch LeasePak Application Client. The .bat file will call the AD server and fetch the ADFS token.
- The ADFS mode will bypass the following screen:
- LeasePak launched in ADFS mode.
API Web Services
Following are the steps to access LeasePak API Web Services in ADFS mode:
- Follow the instructions described in the mPower Configuration and Deployment document to set the web.xml and leasepak.xml files for mPower configuration and deployment.
- Set web.xml
and leasepak.xml
parameters for LeasePak ADFS mode to access web services and their methods. ADFS mode works same as Header Authentication mode where environment
parameters are passed in leasepak.xml and user parameters are sent as part of SOAP <header> call. Following are the parameters
required for ADFS mode:
<env-entry> <env-entry-name>authmode</env-entry-name> <env-entry-type>java.lang.String</env-entry-type> <env-entry-value>ADFS</env-entry-value> </env-entry>
- Set following parameter in the SOAP <header> of API call:
<soapenv:Header> <auth> <login> <user>apiuser</user> <token>123456</token> </login> </auth> </soapenv:Header>
- Run the method. It will ensure the connection with ADFS Token server, validates LeasePak username and ADFS token, process it and runs the API call in ADFS mode.
LeasePak Utilities
The LeasePak command line program lease/util can be run in ADFS mode, provided that the user account is a Utility Unix shared user account.
Following are the steps to run LeasePak Utilities in ADFS mode:
- Log in to unix as Utility Unix shared user
- Go to home directory
- Create a shell script. The shell script must have the ADFS Token and the command to run lputil in shared mode. Following are the parameters:
- token
- username
- path
- env
- username
The format of the script is:
#!/bin/sh export LEASEPAK_ADFS_TOKEN=[token] sudo -u proxy-unix-user path-to-lputil_shared top-directory [env_name] [username]
In the following example, 'Hello' is LeasePak ADFS Token. The value of environment variable LEASEPAK_ADFS_TOKEN is an encrypted and base-64'd token string. The Proxy Unix user name is 'lpshared', the version is 7.4a, the environment name is 'prod', and the LeasePak user name is 'user1':
export LEASEPAK_ADFS_TOKEN=Hello % sudo -u lpshared /opt/nst/v74a/env/prod/bin/lputil_shared /opt/nst/v74a prod user1 - Run the created script and following will appear:
- Enter your selection. Password is not required when running LeasePak utilities in ADFS mode.
EOP Processes
The process of running mPower EOP in ADFS mode is same as described in mPower End of Period Suite
except to setup eop_run.cfg for ADFS authentication mode. The password provided in the configuration file
will work as an ADFS Token to process mPower eop in ADFS mode. The rest of the process of running mpower eop is same as described in
mPower End of Period Suite.
Below is an example of parameters set for ADFS in eop_run.cfg:
#------------------------------------------------------------------------------------------------- # configuration variables for perl scripts #------------------------------------------------------------------------------------------------- MPC_URL=https://mpower.netsoltech.com/mpower-74a/ MPC_LP_AUTH=ADFS MPC_LP_USER=mpower MPC_LP_PASS=mpower MPC_LP_HOST=leasepak.netsoltech.com MPC_LP_PORT=7426 MPC_LP_ENVR=mpower MPC_LP_VERS=7.40 MPC_LOG_FILE=0 MPC_SSL_VERIFY=0
LeasePak Documentation Suite
©
by NetSol Technologies Inc. All rights reserved.
The information contained in this document is the property of NetSol Technologies Inc. Use of the information contained herein is restricted. Conditions of use are subject to change without notice. NetSol Technologies Inc. assumes no liability for any inaccuracy that may appear in this document; the contents of this document do not constitute a promise or warranty. The software described in this document is furnished under license and may be used or copied only in accordance with the terms of said license. Unauthorized use, alteration, or reproduction of this document without the written consent of NetSol Technologies Inc. is prohibited.