パラメータ変更:
'simulation', 1,$sAuthUser = utils::ReadParam('auth_user', 'user_name', true);$sAuthPwd = utils::ReadParam('auth_pwd', 'user_pass', true);// Configuration of the Active Directory connection 'host' => '192.168.**.**', // IP or FQDN of your domain controller'port' => '389', // LDAP port, 398=LDAP, 636= LDAPS'dn' => 'OU=VB-User,DC=CORP,DC=logo',// Domain DN'username' => 'CN=LDAPSearch,OU=Special-User,OU=VB-User,DC=CORP,DC=logo', // username with read access'password' => 'logo@pass', // password for above
root@ITSM:/var/www/html/new_itop# vim webservices/AD_import_accounts.php <?php// Copyright (C) 2011 Combodo SARL//// This program is free software; you can redistribute it and/or modify// it under the terms of the GNU General Public License as published by// the Free Software Foundation; version 3 of the License.//// This program is distributed in the hope that it will be useful,// but WITHOUT ANY WARRANTY; without even the implied warranty of// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the// GNU General Public License for more details.//// You should have received a copy of the GNU General Public License// along with this program; if not, write to the Free Software// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA/** * Sample script to import / synchronize users from an Active Directory server * * @author Erwan Taloc <erwan.taloc@combodo.com> * @author Romain Quetiez <romain.quetiez@combodo.com> * @author Denis Flaven <denis.flaven@combodo.com> * @license http://www.opensource.org/licenses/gpl-3.0.html LGPL */////////////////////////////////////////////////////////////////////////////////// Configuration parameters: adjust them to connect to your AD server// And configure the mapping between AD groups and iTop profiles$aConfig = array( // Configuration of the Active Directory connection 'host' => '192.168.**.**', // IP or FQDN of your domain controller 'port' => '389', // LDAP port, 398=LDAP, 636= LDAPS 'dn' => 'OU=VB-User,DC=CORP,DC=logo',// Domain DN 'username' => 'CN=LDAPSearch,OU=Special-User,OU=VB-User,DC=CORP,DC=logo', // username with read access 'password' => 'logo@pass', // password for above // Query to retrieve and filter the users from AD // Example: retrieve all users from the AD Group "iTop Users" //'ldap_query' => '(&(objectCategory=user)(memberOf=CN=iTop Users,CN=Users,DC=combodo,DC=net))', // Example 2: retrieves ALL the users from AD 'ldap_query' => '(&(objectCategory=user))', // Retrieve all users // Which field to use as the iTop login samaccountname or userprincipalname ? 'login' => 'samaccountname', //'login' => 'userprincipalname', // Mapping between the AD groups and the iTop profiles 'profiles_mapping' => array( //AD Group Name => iTop Profile Name //'Administrators' => 'Administrator', 'ITSM_Administrator' => 'Administrator', 'ITSM_ChangeApprover' => 'Change Approver', 'ITSM_ChangeImplementor' => 'Change Implementor', 'ITSM_ChangeSupervisor' => 'Change Supervisor', 'ITSM_ConfigurationManager' => 'Configuration Manager', 'ITSM_DocumentAuthor' => 'Document author', 'ITSM_PortalPowerUser' => 'Portal power user', 'ITSM_PortalUser' => 'Portal user', 'ITSM_ProblemManager' => 'Problem Manager', 'ITSM_ServiceDeskAgent' => 'Service Desk Agent', 'ITSM_ServiceManager' => 'Service Manager', 'ITSM_SupportAgent' => 'Support Agent', ), // Since each iTop user must have at least one profile, assign the profile // Below to users for which there was no match in the above mapping 'default_profile' => 'Portal user', 'default_language' => 'ZH CN', // Default language for creating new users 'default_organization' => 2, // ID of the default organization for creating new contacts );// End of configuration////////////////////////////////////////////////////////////////////////////////if (file_exists('../approot.inc.php')){ // iTop 1.0.2 include('../approot.inc.php');}else // iTop 1.0 & 1.0.1{ define('APPROOT', '../');}require_once(APPROOT.'application/application.inc.php');require_once(APPROOT.'application/webpage.class.inc.php');require_once(APPROOT.'application/csvpage.class.inc.php');require_once(APPROOT.'application/clipage.class.inc.php');require_once(APPROOT.'application/startup.inc.php');// List of attributes to retrieve$aAttribs = array( 'samaccountname', 'sn', 'givenname', 'userprincipalname', 'cn', 'memberof', 'mail',);$g_aUsersCache = null; // Cache of all the iTop users to speed up searches$g_aProfilesCache = null; // Cache of all iTop profiles/** * Helper function to read attributes from LDAP data * @param hash The LDAP data for one item as returned by ldap_search * @param string The name of the attribute to retrieve * @return mixed null if no such attribute, a scalar or a array depending on the * number of values for the attribute. */ function ReadLdapValue($aEntry, $sValueName){ if (array_key_exists($sValueName, $aEntry)) { $iCount = $aEntry[$sValueName]['count']; switch($iCount) { case 0: // No value, return null return null; case 1: // Just one value, return it return $aEntry[$sValueName][0]; default: // Many values, return all of them as an array // except the 'count' entry $aValues = $aEntry[$sValueName]; unset($aValues['count']); return $aValues; } } return null;}/** * Helper function that processes 1 user at a time * @param $aData hash The input data from Active Directory * @param $index integer The index of the current user in the AD query (for reporting) * @param $aConfig hash The configuration parameter * @param $oChange CMDBChange Change to record all the changes or null if simulation mode * @return string The action undertaken 'created', 'synchronized', 'error' */ function ProcessUser($aData, $index, $aConfig, $oChange = null){ $sAction = 'error'; $sUserLogin = $aData['samaccountname']; if (!is_array($aData['memberof'])) { $aADGroups = array($aData['memberof']); } else { $aADGroups = $aData['memberof']; } $aITopProfiles = array(); foreach($aADGroups as $sGroupString) { $aMatches = array(); $sShortGroupString = ''; if (preg_match('/^CN=([^,]+)/', $sGroupString, $aMatches)) { $sShortGroupString = $aMatches[1]; } //echo "<p>GroupString: $sGroupString => $sShortGroupString</p>"; if (isset($aConfig['profiles_mapping'][$sShortGroupString])) { $aITopProfiles[] = $aConfig['profiles_mapping'][$sShortGroupString]; } } if (count($aITopProfiles) == 0) { // Each user must have at least one profile // Assign the 'default_profile' to this user $aITopProfiles[] = $aConfig['default_profile']; } echo "<h2>User#{$index}: {$aData['cn']}</h2>\n"; echo "<table>"; foreach($aData as $sAttrib => $value) { echo "<tr><td style=\"vertical-align:top;background-color:eee;\">$sAttrib</td>"; echo "<td style=\"vertical-align:top;background-color:eee;\">"; if (is_array($value)) { echo implode('<br/>', $value); } else { echo htmlentities($value); } echo "</td></tr>\n"; } echo "<tr><td style=\"vertical-align:top;background-color:eee;\">iTop Profiles</td>"; echo "<td style=\"vertical-align:top;background-color:eee;\">"; echo implode('<br/>', $aITopProfiles); echo "</td></tr>\n"; echo "</table>"; $sLogin = $aData[$aConfig['login']]; $oITopUser = GetUserByLogin($sLogin); if ($oITopUser == null) { // Check if a contact needs to be created or not $oPerson = GetPersonByEmail($aData['mail']); if (is_object($oPerson)) { echo "<p>A person with the email='{$aData['mail']}' was found ".$oPerson->GetHyperlink().". This person will be used when creating the account.</p>"; } else if ($oPerson == null) { echo "<p>A new person will be created.</p>"; $oPerson = new Person(); $oPerson->Set('first_name', $aData['givenname']); $oPerson->Set('name', $aData['sn']); $oPerson->Set('email', $aData['mail']); $oPerson->Set('org_id', $aConfig['default_organization']); if ($oChange != null) { $oPerson->DBInsertTracked($oChange); } } else { // Error ! Several matches found ?? throw new Exception($oPerson); } $sAction = 'created'; echo "<h2>User $sLogin will be <em>created</em> in iTop</h2>"; $oITopUser = new UserLDAP; $oITopUser->Set('login', $sLogin); $oITopUser->Set('contactid', $oPerson->GetKey()); $oITopUser->Set('language', $aConfig['default_language']); // Update the profiles $oLinkSet = DBObjectSet::FromScratch('URP_UserProfile'); foreach($aITopProfiles as $sProfile) { $oLink = new URP_UserProfile; $iProfileId = GetProfileByName($sProfile); if ($iProfileId != null) { $oLink->Set('profileid', $iProfileId); $oLinkSet->AddObject($oLink); } else { echo "<p><b>Error: the profile '$sProfile' does not exist in iTop, verify the profiles_mapping configuration!</b></p>"; } } $oITopUser->Set('profile_list', $oLinkSet); if ($oChange != null) { $oITopUser->DBInsertTracked($oChange); } } else if(is_object($oITopUser)) { $sAction = 'synchronized'; echo "<h2>User $sLogin (UserLDAP::".$oITopUser->GetKey().") will be <em>synchronized</em> in iTop</h2>"; // Update the profiles $oLinkSet = DBObjectSet::FromScratch('URP_UserProfile'); $oITopUser->Set('login', $sLogin); foreach($aITopProfiles as $sProfile) { $oLink = new URP_UserProfile; $iProfileId = GetProfileByName($sProfile); if ($iProfileId != null) { $oLink->Set('profileid', $iProfileId); $oLinkSet->AddObject($oLink); } else { echo "<p><b>Error: the profile '$sProfile' does not exist in iTop, verify the profiles_mapping configuration!</b></p>"; } } $oITopUser->Set('profile_list', $oLinkSet); if ($oChange != null) { $oITopUser->DBUpdateTracked($oChange); } } else { // Error, another kind of user already exists with the same login ? echo "<h2 style=\"color:#C00\">Error: $oITopUser</h2>"; } return $sAction;}/** * Search the given user (identified by its login) in the iTop database * @param $sLogin string The login of the user * @return mixed null => nothing found, object => the user to synchronize, string => error message */function GetUserByLogin($sLogin){ global $g_aUsersCache; $result = null; if ($g_aUsersCache == null) InitUsersCache(); if (isset($g_aUsersCache[$sLogin])) { $oUser = $g_aUsersCache[$sLogin]; if (get_class($oUser) != 'UserLDAP') { $result = "A user with the same login ($sLogin), but not managed by LDAP already exists in iTop, the AD record will be ignored."; } else { $result = $oUser; } } return $result;}/** * Initializes the cache for quickly searching iTop users * @param none * @return integer Number of users fetched from iTop */function InitUsersCache(){ global $g_aUsersCache; $sOQL = "SELECT User"; $oSearch = DBObjectSearch::FromOQL($sOQL); $oSet = new CMDBObjectSet($oSearch); $iRet = $oSet->Count(); while($oUser = $oSet->Fetch()) { $g_aUsersCache[$oUser->Get('login')] = $oUser; } return $iRet;}/** * Retrieves the ID of a profile (in iTop) base on its name * @param $sProfile string Name of the profile * @return integer ID of the profile, or null is not found */function GetProfileByName($sProfileName){ global $g_aProfilesCache; $iRet = null; if ($g_aProfilesCache == null) InitProfilesCache(); if (isset($g_aProfilesCache[$sProfileName])) { $iRet = $g_aProfilesCache[$sProfileName]; } return $iRet;}/** * Initializes the cache of the iTop profiles * @param none * @return void */function InitProfilesCache(){ global $g_aProfilesCache; $sOQL = "SELECT URP_Profiles"; $oSearch = DBObjectSearch::FromOQL($sOQL); $oSet = new CMDBObjectSet($oSearch); while($oProfile = $oSet->Fetch()) { $g_aProfilesCache[$oProfile->GetName()] = $oProfile->GetKey(); }}/** * Search for a Person by email address * @param $sEmail string * @return mixed Person (if found) or null (not found) or string (error) */function GetPersonByEmail($sEmail){ static $oSearch = null; // OQL Query cache $person = null; if ($oSearch == null) { $sOQL = 'SELECT Person WHERE email = :email'; $oSearch = DBObjectSearch::FromOQL($sOQL); } $oSet = new CMDBObjectSet($oSearch, array(), array('email' => $sEmail)); switch($oSet->Count()) { case 0: $person = null; break; case 1: $person = $oSet->Fetch(); break; default: $person = ' several matches found: '.$oSet->Count()." persons have the email address '$sEmail'"; } return $person; } /****************************************************************************** * * Main program * ******************************************************************************/if (utils::IsModeCLI()){ $sAuthUser = utils::ReadParam('auth_user', 'user_name', true); $sAuthPwd = utils::ReadParam('auth_pwd', 'user_pass', true); if (UserRights::CheckCredentials($sAuthUser, $sAuthPwd)) { UserRights::Login($sAuthUser); // Login & set the user's language } else { echo "Access restricted or wrong credentials ('$sAuthUser')"; exit; }}else{ $_SESSION['login_mode'] = 'basic'; require_once('../application/loginwebpage.class.inc.php'); LoginWebPage::DoLogin(); // Check user rights and prompt if needed $sCSVData = utils::ReadPostedParam('csvdata');}if (!UserRights::IsAdministrator()){ echo '<p>Access is restricted to administrators</p>'; exit;}// By default, run in simulation mode (i.e do nothing)#'simulation', 1, test#'simulation', 0, exec$bSimulationMode = utils::ReadParam('simulation', 1, true);$oMyChange = null;if (!$bSimulationMode){ $oMyChange = MetaModel::NewObject("CMDBChange"); $oMyChange->Set("date", time()); if (UserRights::IsImpersonated()) { $sUserString = Dict::Format('UI:Archive_User_OnBehalfOf_User', UserRights::GetRealUser(), UserRights::GetUser()); } else { $sUserString = UserRights::GetUser(); } $oMyChange->Set("userinfo", $sUserString); $oMyChange->DBInsert();}else{ echo "<h1 style=\"color:#900\">Simulation mode -- no action will be performed</h1>"; echo "<p>Set the parameter simulation=0 to trigger the actual execution.</p>";} $ad = ldap_connect($aConfig['host'], $aConfig['port']) or die( "Could not connect to {$aConfig['host']} on port {$aConfig['port']}!" );echo "<p>Connected to {$aConfig['host']} on port {$aConfig['port']}</p>\n";// Set version numberldap_set_option($ad, LDAP_OPT_PROTOCOL_VERSION, 3) or die ("Could not set ldap protocol");ldap_set_option($ad, LDAP_OPT_REFERRALS,0) or die ("could no se the ldap referrals");// Binding to ldap server$bd = ldap_bind($ad, $aConfig['username'], $aConfig['password']) or die ("Could not bind");echo "<p>Identified as {$aConfig['username']}</p>\n";$sLdapSearch = $aConfig['ldap_query'];echo "<p>LDAP Query: '$sLdapSearch'</p>";$search = ldap_search($ad, $aConfig['dn'], $sLdapSearch /*, $aAttribs*/) or die ("ldap search failed");$entries = ldap_get_entries($ad, $search);$index = 1;$aStatistics = array( 'created' => 0, 'synchronized' => 0, 'error' => 0,);$iCreated = 0;$iSynchronized = 0;$iErrors = 0; if ($entries["count"] > 0){ $iITopUsers = InitUsersCache(); echo "<h1>{$entries["count"]} user(s) found in Active Directory, $iITopUsers (including non-LDAP users) found in iTop.</h1>\n"; foreach($entries as $key => $aEntry) { //echo "<pre class="brush:php;toolbar:false">$key\n"; //print_r($aEntry); //echo "\n"; if (strcmp($key,'count') != 0) { $aData = array(); foreach($aAttribs as $sName) { $aData[$sName] = ReadLdapValue($aEntry, $sName); } if (empty($aData['mail'])) { $aData['mail'] = $aData['userprincipalname']; } try { $sAction = ProcessUser($aData, $index, $aConfig, $oMyChange); } catch(Exception $e) { echo "
An error occured while processing $index: ".$e->getMessage()."
"; $sAction = 'error'; } echo "Nothing found !
\n"; echo "LDAP query was: $sLdapSearch
\n";}ldap_unbind($ad);if ($bSimulationMode){ echo "$sKey | \n"; echo "$iValue |
コマンド Run のパラメータを入力します:
root@ITSM:/var/www/html/new_itop# cd webservices/root@ITSM:/var/www/html/new_itop/webservices# php AD_import_accounts.php
スケジュールされたタスクで実行;
root@itsm-demo:~# cat /etc/crontab # /etc/crontab: system-wide crontab# Unlike any other crontab you don't have to run the `crontab'# command to install the new version when you edit this file# and files in /etc/cron.d. These files also have username fields,# that none of the other crontabs do.SHELL=/bin/shPATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin# m h dom mon dow user command17 * * * * root cd / && run-parts --report /etc/cron.hourly25 6 * * * root test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.daily )47 6 * * 7 root test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.weekly )52 6 1 * * root test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.monthly )#1 */24 * * * root cd /var/www/html/itop.new/webservices/;php AD_import_accounts.php > /dev/null 2>&1