Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
devel:documentation:adm:systems:winrm_ad_connector [2019/10/17 11:05] fiserp [Installation] |
devel:documentation:adm:systems:winrm_ad_connector [2020/05/25 12:34] kucerar Versions and compatibility |
||
---|---|---|---|
Line 5: | Line 5: | ||
Typical use cases for this combined connector are: | Typical use cases for this combined connector are: | ||
- | * Management of home directories - User is created via AD connector and home directory is created by WinRM Connector (powershell) | + | * Management of home directories - User is created via AD connector and home directory is created by WinRM Connector (powershell). Owner of home directory can be set only locally. |
* Management of o365 | * Management of o365 | ||
* Management of Exchange | * Management of Exchange | ||
Line 44: | Line 44: | ||
Powershell scripts are in subfolders. It's not only " | Powershell scripts are in subfolders. It's not only " | ||
- | All of these scripts logging into connector server log | + | All of these scripts logging into connector server log. All log messages are shown after powershell script is executed and the control is returned into connector. So it can see that the log is frozen if the powershell script will run some time. Disadvantage is, if your powershell script froze for real you will not see any log. This can happen for example if you execute some command which will wait for user input, but you can prevent this one by using [[devel: |
Then in folder " | Then in folder " | ||
Line 80: | Line 80: | ||
* Write powershell scripts, which will be performing desired operations on MS server (CREATE, UPDATE, ...) | * Write powershell scripts, which will be performing desired operations on MS server (CREATE, UPDATE, ...) | ||
* Write python scripts that transform data from ConId API to powershell script (examples in GIT repository) | * Write python scripts that transform data from ConId API to powershell script (examples in GIT repository) | ||
+ | |||
+ | ====== Version and compatibility ====== | ||
+ | * 1.0.0 - IdM 9.x and above | ||
+ | * 1.0.1 - IdM 9.x and above | ||
+ | * 1.0.2 - IdM 9.x and above | ||
+ | Cross domain feature available: | ||
+ | * 1.0.3 - IdM LTS 9.7.x with Extras module 1.8.1 | ||
+ | * 1.0.4 - IdM 10.3.0 and above | ||
+ | |||
+ | If you want to use IdM 10.0.0, 10.1.0 or 10.2.0 and be able to use cross domain functions you need to update IdM to 10.3.0, if you don't need cross domain feature and don't want to update IdM you can try to use connector 1.0.2 | ||
===== Provisioning ===== | ===== Provisioning ===== | ||
Line 101: | Line 111: | ||
===== Scripts ===== | ===== Scripts ===== | ||
+ | |||
+ | For more information about how to write scripts, follow [[devel: | ||
+ | |||
==== python ==== | ==== python ==== | ||
Python scripts should start with these two lines: | Python scripts should start with these two lines: | ||
Line 118: | Line 131: | ||
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. | 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. | ||
+ | <note tip> | ||
+ | <note tip>For search and delete operations IdM only sends uid. So in this scripts you cannot use any other attributes. For example someone would want to rename home directory in delete script and leave it there for period of time as backup. But in this situation you can only add to home directory' | ||
===== Installation ===== | ===== Installation ===== | ||
For using WinRM part of this connector you need to install a few things which is needed, otherwise you can skip these steps. | For using WinRM part of this connector you need to install a few things which is needed, otherwise you can skip these steps. | ||
Line 138: | Line 152: | ||
Now we have prepared the tool which is used by our connector. Next you need to install java connector server. Connector server is not mandatory but as we wrote in the first section it is strongly recommended. | Now we have prepared the tool which is used by our connector. Next you need to install java connector server. Connector server is not mandatory but as we wrote in the first section it is strongly recommended. | ||
- | - Follow [[devel: | + | - Follow [[devel: |
- Put '' | - Put '' | ||
+ | - Put CA certificate to WinRM server in this file inside connector server installation - '' | ||
+ | - Put CA certificate to AD servers in the [[devel: | ||
+ | |||
- Configure WinRM on windows server or check if WinRM is accessible. You can follow steps from our [[tutorial: | - Configure WinRM on windows server or check if WinRM is accessible. You can follow steps from our [[tutorial: | ||
Line 194: | Line 211: | ||
You can configure the order of connectors. Default behavior is that AD connector is first. | You can configure the order of connectors. Default behavior is that AD connector is first. | ||
{{ : | {{ : | ||
+ | < |