Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision Both sides next revision
devel:documentation:systems:dev:winrm_connector [2019/06/14 13:28]
cirkval 		devel:documentation:systems:dev:winrm_connector [2019/07/10 06:52]
kucerar roles, script tips
Line 100: Line 100:
 | \_\_ACCOUNT\_\_  | CREATE, UPDATE, DELETE, SEARCH  | | \_\_ACCOUNT\_\_  | CREATE, UPDATE, DELETE, SEARCH  |
 | \_\_GROUP\_\_    | NONE                  | | \_\_GROUP\_\_    | NONE                  |
 +
 +===== Managing users groups =====
 +When you use this connector for some system where you need to manage groups for users (OpenLims). Attribute for roles must be called "roles" is schema definition. Then it's work in the same way as roles for AD. That's mean you need to create role in IdM which will have assigned this system and in mapping override attribute "roles" with value which the system accept. Strategy should be Merge or Authoritative merge 
 +
 +===== Scripts =====
 +==== python ====
 +Python scripts should start with these two lines:
 +<code>#!/usr/bin/env python
 +# -*- coding: utf-8 -*-</code>
 +
 +The second line is important because in python 2.x default encoding is ASCII so if don't specify the encoding in python file then we will have problems with using diacritics.
 +Then if we need to load powershell script into python and replace some params, It's recommended to open with encoding.
 +<code>
 +import codecs
 +f = codecs.open(os.environ["script"], encoding='utf-8', mode='r') #os.environ["script"] is path to script which is send from IdM configuration
 +command = f.read()
 +command = command.replace("$firstName", winrm_wrapper.getParam("firstName"))
 +</code>
 +For getting parameter from environment you can use method in winrm_wrapper which will return value or empty string if the variable is not in environment. It will return value as unicode with utf-8 encoding
 +
 +We are using encoding otherwise you will have problem with diacritics in powershell when you want to encode the powershell script before sending it via WinRM.
 +
  
 ===== Installation ===== ===== Installation =====
Line 121: Line 143:
 You will probably need to add these libs into classpath in ConnectorServer.sh or ConnectorServer.bat it depends on your OS. You will probably need to add these libs into classpath in ConnectorServer.sh or ConnectorServer.bat it depends on your OS.
  
-Now you can put winrm-connector-0.5.jar to the bundles folder inside connector server and you can start it.+Now you can put winrm-connector-1.0.0.jar to the bundles folder inside connector server and you can start it.
  
 Next thing which you need to do is configure WinRM on windows server or check if WinRM is accessible. You can follow steps from out [[tutorial:adm:configuration_-_winrm|tutorial]] Next thing which you need to do is configure WinRM on windows server or check if WinRM is accessible. You can follow steps from out [[tutorial:adm:configuration_-_winrm|tutorial]]