• Recent
    • Unsolved
    • Tags
    • Popular
    • Users
    • Groups
    • Search
    • Register
    • Login

    Extend LDAP plugin to support AD authentication

    Scheduled Pinned Locked Moved Solved
    Feature Request
    8
    64
    28.4k
    Loading More Posts
    • Oldest to Newest
    • Newest to Oldest
    • Most Votes
    Reply
    • Reply as topic
    Log in to reply
    This topic has been deleted. Only users with topic management privileges can see it.
    • george1421G
      george1421 Moderator
      last edited by

      Well here is my proof of concept code. In AD I setup two groups FOG_Admins and FOG_Users. The script outputs the following
      false := user is not authorized
      1 := User is authorized and is in the FOG_Users group
      2 := User is authorized and is in the FOG_Admins group

      I was going to go with the whole bindDN and bindPassword route, but that also meant that I would have to save the bindPass value in the database. To do that I would have to come up with a way to protect (encrypt) the password and all that. So I flipped the script around to use the person who is logging, their credentials to query AD.

      The next steps here are to intergrate the script below into ldapAuth (which shouldn’t be hard at all) then update the database fields, and other creations bits. The last part will be to mess with the ldap gui interface which has me a bit confused on the layout.

      But at the end of the day this is surely possible to get fog to authenticate against AD.

      <?php
      
          function ldapParseDn($dn) {
              /**
               * Returns array of: array (
               *     [CN] => array( username )
               *     [OU] => array( UNITNAME, Region, Country )
               *     [DC] => array ( subdomain, domain, com )
               * )
              **/
      
              $parsr=ldap_explode_dn($dn, 0);
              $out = array();
              foreach($parsr as $key=>$value) {
                  if(FALSE !== strstr($value, '=')) {
                      list($prefix,$data) = explode("=",$value);
                      $prefix = strtoupper($prefix);
                      $data=preg_replace("/\\\([0-9A-Fa-f]{2})/e", "''.chr(hexdec('\\1')).''", $data);
                      if(isset($current_prefix) && $prefix == $current_prefix) {
                          $out[$prefix][] = $data;
                      } else {
                          $current_prefix = $prefix;
                          $out[$prefix][] = $data;
                      }
                  }
              }
              return $out;
          }
      
          $user = 'testuser';
          $pass = 'testuser.1';
          $server = '192.168.1.5';
      
              // clean up user name we only want the user's short name without any domain component
              // note I did not try to understand the regex expression but I expect there to be
              // issues with non-us english characters, just saying.
              $user = trim(preg_replace('/[^a-zA-Z0-9\-\_@\.]/', '', $user));
      
              // open connection to the server
              $ldapconn = ldap_connect($server,389);
              ldap_set_option($ldapconn, LDAP_OPT_PROTOCOL_VERSION, 3);
              ldap_set_option($ldapconn, LDAP_OPT_REFERRALS, 0);
      
              $accessLevel = 0;
              // test to confirm that script will handle mixed case
              $userSearchDN = 'ou=nyc,dc=domain,DC=com';
              $adminGroup = 'FOG_Admins';
              $userGroup = 'FOG_Users';
              // test to confirm that script will handle mixed case
              $grpMemberAttr = strtolower('memberOf');
      
              $entries = ldapParseDN($userSearchDN);
              $userDomain = implode(".",$entries['DC']);
              $userDN = sprintf('%s@%s', $user, $userDomain);
      
              if ( ldap_bind($ldapconn, $userDN, $pass) ) {
                  // If we get to here the user is authorized, now lets get the group membership
                  $filter = sprintf('(&(objectCategory=person)(%s=%s))', 'sAMAccountName', $user);
      
                  $attr = array( $grpMemberAttr );
                  $result = ldap_search($ldapconn, $userSearchDN, $filter, $attr);
      
                  // count the number of entries returned
                  $retcount = ldap_count_entries($ldapconn, $result);
      
                  if ($retcount > 0) {
                      $entries = ldap_get_entries($ldapconn, $result);
      
                      // check groups for membership
                      foreach($entries[0][$grpMemberAttr] as $grps) {
                          // is admin user, set level and break loop
                          if(strpos( $grps, $adminGroup )) { $accessLevel = 2; break; }
      
                          // is user, set level and keep looking just incase user is in both groups
                          if(strpos( $grps, $userGroup )) $accessLevel = 1;
                      }
                  }
                  // close our connection as bindDN
                  ldap_unbind( $ldapconn );
      
                  print $accessLevel;
      
              } else {
                  print 'unable to bind using user info, user is not authorized in ldap';
      
              }
       ?>
      
      
      

      Please help us build the FOG community with everyone involved. It's not just about coding - way more we need people to test things, update documentation and most importantly work on uniting the community of people enjoying and working on FOG!

      Wayne WorkmanW 1 Reply Last reply Reply Quote 1
      • Wayne WorkmanW
        Wayne Workman @george1421
        last edited by

        @george1421 However will these changes be reverse compatible with ldap still?

        Please help us build the FOG community with everyone involved. It's not just about coding - way more we need people to test things, update documentation and most importantly work on uniting the community of people enjoying and working on FOG!
        Daily Clean Installation Results:
        https://fogtesting.fogproject.us/
        FOG Reporting:
        https://fog-external-reporting-results.fogproject.us/

        george1421G 1 Reply Last reply Reply Quote 0
        • george1421G
          george1421 Moderator @Wayne Workman
          last edited by

          @Wayne-Workman Not sure I understand?

          The intent is to make/change the ldap plugin to work with AD/OpenLDAP/and the novel one. Unfortunately I have to add some fields to the database to fill in the assumptions in the code. So one I prove it out (we) need to decide if I update the current ldap plugin code (requiring users that have it installed already, to uninstall and reinstall+configure it) or to create a whole new (enhanced) ldap plugin. That decision will be up to the developers on how they want to handle it. Right now I’m doing a proof of concept (on my production server) to answer can it work.

          Testing so far has been very positive. Right now I ran into a roadblock with the hooks that I need to work through. But the problem here is my ignorance of how hooks work not a coding problem.

          Please help us build the FOG community with everyone involved. It's not just about coding - way more we need people to test things, update documentation and most importantly work on uniting the community of people enjoying and working on FOG!

          Wayne WorkmanW 1 Reply Last reply Reply Quote 1
          • Wayne WorkmanW
            Wayne Workman @george1421
            last edited by

            @george1421 Well of course I am all for eliminating assumptions. Writing code that works for one person’s setup is not a solution. And I get what you’re doing now. Just do your thing George.

            Please help us build the FOG community with everyone involved. It's not just about coding - way more we need people to test things, update documentation and most importantly work on uniting the community of people enjoying and working on FOG!
            Daily Clean Installation Results:
            https://fogtesting.fogproject.us/
            FOG Reporting:
            https://fog-external-reporting-results.fogproject.us/

            1 Reply Last reply Reply Quote 0
            • Lee RowlettL
              Lee Rowlett Developer
              last edited by

              what issues are you having with the hooks? @george1421? happy to assist where possible

              george1421G 1 Reply Last reply Reply Quote 1
              • george1421G
                george1421 Moderator @Lee Rowlett
                last edited by

                @Lee-Rowlett Thank you for the offer. Tom offered to look at the code last night. I think he found out what I did wrong/needed.

                Please help us build the FOG community with everyone involved. It's not just about coding - way more we need people to test things, update documentation and most importantly work on uniting the community of people enjoying and working on FOG!

                1 Reply Last reply Reply Quote 1
                • Tom ElliottT
                  Tom Elliott
                  last edited by

                  I’ve added the suggested changes to the main ldap plugin. This is by no means ready to actually be used, @george1421 and I are going to be testing the crap out of this, but the progress is quite significant. Of course @Lee-Rowlett or anybody who is willing to give a test and feedback about failings and areas that may need improvement please run it and test it. It is currently under the working-RC-11 branch on GIT. I hope to have a completed, mostly working, ready for the RC-11 release.

                  Please help us build the FOG community with everyone involved. It's not just about coding - way more we need people to test things, update documentation and most importantly work on uniting the community of people enjoying and working on FOG! Get in contact with me (chat bubble in the top right corner) if you want to join in.

                  Web GUI issue? Please check apache error (debian/ubuntu: /var/log/apache2/error.log, centos/fedora/rhel: /var/log/httpd/error_log) and php-fpm log (/var/log/php*-fpm.log)

                  Please support FOG if you like it: https://wiki.fogproject.org/wiki/index.php/Support_FOG

                  1 Reply Last reply Reply Quote 0
                  • Tom ElliottT
                    Tom Elliott
                    last edited by

                    Just for tracking purposes for those that would like to try this:

                    https://github.com/FOGProject/fogproject/tree/working-RC-11

                    Under packages/web/lib/plugins/ldap you will find the plugin.

                    Easiest way to get it would be to simply install the ldap plugin after installing working-RC-11 branch. I don’t recommend this only because while it’s a “WIP” and addresses bugs and minor improvements/fixes around what’s being found from RC-10, it’s also meaning those on RC-11 would be returning info that’s rather irrelevant for the time being. I’d prefer people to work on RC-10 and get a thorough list of bugs and issues to work out. That said, any of the developers and moderators that would like to install please do, I can fix the things I miss due to it not being in the “mainstream” of things which can help make RC-11 that much more suitable for environments.

                    This one exception (ldap) is the only thing I’d like to see people testing from RC-11 as it could use VAST amounts of improvements and make using FOG in an AD Environment that much easier to control.

                    For example, with the new modifications (once fully completed), you can define ldap authentication from eDirectory, openldap, ldap, and Active directory. You can associate groups in your ldap choice to allow users mobile access, and your IT team admin access. I hope something like SSO of this sort will make it into FOG 2.0 as well, which is why I’m kind of excited for this plugin to get revamped.

                    @Fernando-Gietz, @george1421, and myself have had the most authoring done for this plugin and have been added to the author’s of this plugin. @x23piracy You helped tremendously a few months ago with testing and providing an open test ring for me to use although it may not have accomplished what the two of us had hoped for.

                    Thank you @george1421 for actually kind of kickstarting this plugin back into shape. Thank you @Fernando-Gietz for actually establishing the basis of the plugin.

                    Anybody who would like to try this out so we can make it much better, please do and keep us posted. Please, for the time being, don’t post this into bugs though. I’m aware of the issues LDAP plugin currently has which is kind of why the work has been started to make it into a truly usable plugin.

                    Please help us build the FOG community with everyone involved. It's not just about coding - way more we need people to test things, update documentation and most importantly work on uniting the community of people enjoying and working on FOG! Get in contact with me (chat bubble in the top right corner) if you want to join in.

                    Web GUI issue? Please check apache error (debian/ubuntu: /var/log/apache2/error.log, centos/fedora/rhel: /var/log/httpd/error_log) and php-fpm log (/var/log/php*-fpm.log)

                    Please support FOG if you like it: https://wiki.fogproject.org/wiki/index.php/Support_FOG

                    1 Reply Last reply Reply Quote 2
                    • george1421G
                      george1421 Moderator
                      last edited by

                      I’m going to start a debugging session in a few minutes with this new ldap code. I would consider the current state as alpha code.

                      Todo items:

                      1. Review the code to ensure it still flows like I intended.
                      2. Load the modified code into my production environment and confirm it works as the proof of concept code does.
                      3. Work with changing case of groups, dn paths to make sure all case sensitivity is gone.
                      4. Clean up the web gui configuration page. Currently there are fields that don’t have any impact on the code (binddn, bindpass, searchscope). The elements were built in place in case we needed to create a more complex ldap auth.

                      This code does make a few assumptions about the target environment. I did use less complex logic to keep the lines of code down. It should work well for the different ldap backends. Only testing will tell.

                      Please help us build the FOG community with everyone involved. It's not just about coding - way more we need people to test things, update documentation and most importantly work on uniting the community of people enjoying and working on FOG!

                      1 Reply Last reply Reply Quote 1
                      • george1421G
                        george1421 Moderator
                        last edited by

                        Its been a few days since I posted an update to this. I’ve been debugging and have the ldap authentication working with AD. So the actual ldap authentication is working fine. I’ve run into a snag passing the authorized flag back to fog. I’m sure that can be worked out soon. Beyond that I’ve been testing with RC8 code. Once that is working I’ll stand up a new RC11 instance of FOG and confirm. In the end we are making progress with an end in sight.

                        Please help us build the FOG community with everyone involved. It's not just about coding - way more we need people to test things, update documentation and most importantly work on uniting the community of people enjoying and working on FOG!

                        adukes40A 1 Reply Last reply Reply Quote 1
                        • adukes40A
                          adukes40 @george1421
                          last edited by

                          @george1421 Is this stricly to allow signing into the FOG Gui with AD credentials or will we be able to interact with AD via fog. Like assigning snapins to certain AD groups.

                          george1421G 1 Reply Last reply Reply Quote 0
                          • george1421G
                            george1421 Moderator @adukes40
                            last edited by george1421

                            @adukes40 This is only for user login. So far I’ve only tested via the web gui.

                            Please help us build the FOG community with everyone involved. It's not just about coding - way more we need people to test things, update documentation and most importantly work on uniting the community of people enjoying and working on FOG!

                            adukes40A 1 Reply Last reply Reply Quote 1
                            • adukes40A
                              adukes40 @george1421
                              last edited by

                              @george1421 would it be able to spawn from there? I have no idea how in depth it is. Im just generally curious.

                              george1421G 1 Reply Last reply Reply Quote 0
                              • george1421G
                                george1421 Moderator @adukes40
                                last edited by

                                @adukes40 While anything is possible it would be a lot of work, and it would then tie FOG to requiring an AD infrastructure.

                                I can say from a programming standpoint the code that FOG is built on can communicate with ldap pretty easily. So its possible to do. The issue is having enough motivation to pull it off. I looked at the ldap plugin that was in fog and have experience with programming queries to LDAP so there wasn’t a huge learning curve to update the plugin, plus what was there was sound already, they were just missing a few things.

                                Please help us build the FOG community with everyone involved. It's not just about coding - way more we need people to test things, update documentation and most importantly work on uniting the community of people enjoying and working on FOG!

                                1 Reply Last reply Reply Quote 1
                                • JJ FullmerJ
                                  JJ Fullmer Testers
                                  last edited by

                                  I did a little testing on this and wasn’t able to add a ldap server. Put in all the information and I just get “LDAP ID # is not valid” I got ID 1 and 2 as invalid with 2 attempts at adding a server. @Tom-Elliott said that you might want to know.

                                  Have you tried the FogApi powershell module? It's pretty cool IMHO
                                  https://github.com/darksidemilk/FogApi
                                  https://fogapi.readthedocs.io/en/latest/
                                  https://www.powershellgallery.com/packages/FogApi
                                  https://forums.fogproject.org/topic/12026/powershell-api-module

                                  george1421G 2 Replies Last reply Reply Quote 0
                                  • george1421G
                                    george1421 Moderator @JJ Fullmer
                                    last edited by

                                    @JJ-Fullmer Wow interesting. I’ll surely take a look at that tonight. I installed RC11 B58 (I think) this AM after Tom updated the master code. The one thing that you must do if the LDAP plugin was installed before (now) is that you must uninstall and reinstall the plugin because the internal structure has changed. This AM after the refresh I had to recreate the ldap server and it installed correctly. Just to be sure uninstall the ldap plugin and then readd it back in.

                                    As far as the status of the LDAP plugin, its (should be) almost complete. The only outstanding issue is adding the code for reauth. So as it stands right now once you are authorized via LDAP, you are authorized forever even if you kill the AD account (which is not to cool). I have a way to fix this tonight.

                                    I’ll add a simple how to to this thread on what the plugin is expecting, but its pretty straight forward.

                                    Please help us build the FOG community with everyone involved. It's not just about coding - way more we need people to test things, update documentation and most importantly work on uniting the community of people enjoying and working on FOG!

                                    1 Reply Last reply Reply Quote 1
                                    • george1421G
                                      george1421 Moderator @JJ Fullmer
                                      last edited by

                                      @JJ-Fullmer OK I couldn’t resist checking. I have B54 installed and I was able to add a second ldap server without issue. Let me refresh my install and see if something changed from B54

                                      Please help us build the FOG community with everyone involved. It's not just about coding - way more we need people to test things, update documentation and most importantly work on uniting the community of people enjoying and working on FOG!

                                      1 Reply Last reply Reply Quote 1
                                      • george1421G
                                        george1421 Moderator
                                        last edited by

                                        Progress is going very well with the ldap plugin. But we found that when we start bringing in other ldap serves to test, some of the shortcuts that worked for M$ did not work so well with other ldap servers. To that end, I wrote another proof of concept code using the long way to get a user’s ldap attributes. In this method I have to use an authorized read only user to query the ldap server to locate the user’s ldap account, then I use that ldap account to relogin to the ldap server to pick up the user’s group associations.

                                        <?php
                                        
                                            // the user we are going to authenticate
                                            $user = 'user1234';
                                            $pass = 'Password';
                                        
                                            // IP address or fqdn of ldap server
                                            $server = '192.168.1.5';
                                        
                                            // credentials that have read access to the LDAP server
                                            $bindDN = 'cn=Bob Jones,ou=Users,ou=nyc,dc=domain,dc=com';
                                            $bindPass = 'Password.2';
                                        
                                            // How deep in ldap from search base are we going to look for the user
                                            $searchScope = 2;
                                        
                                                // clean up user name we only want the user's short name without any domain component
                                                // note I did not try to understand the regex expression but I expect there to be
                                                // issues with non-us english characters, just saying.
                                                $user = trim(preg_replace('/[^a-zA-Z0-9\-\_@\.]/', '', $user));
                                        
                                                // open connection to the server
                                                $ldapconn = ldap_connect($server,389);
                                                ldap_set_option($ldapconn, LDAP_OPT_PROTOCOL_VERSION, 3);
                                                ldap_set_option($ldapconn, LDAP_OPT_REFERRALS, 0);
                                        
                                                $accessLevel = 0;
                                                $userSearchDN = 'ou=nyc,dc=domain,dc=com';
                                                $adminGroup = 'FoG_Admins';
                                                $userGroup = 'FOG_Users';
                                                $grpMemberAttr = strtolower('memberOf');
                                        
                                                if ( ldap_bind($ldapconn, $bindDN, $bindPass) ) {
                                                    // for the filter we are searching for a person with an NT style account like the contents of $user
                                                    $filter = sprintf('(&(objectCategory=inetOrgPerson)(%s=%s))', 'sAMAccountName', $user);
                                        
                                                    // we want to return the user's DN so that we can bind as the user
                                                    // we will get his DN based on his samaccountname for AD
                                                    $attr = array( 'dn' );
                                        
                                                    switch ($searchScope) {
                                                        case 1:
                                                            // LDAP_SCOPE_ONELEVEL search one level down but not base
                                                            $result = ldap_list($ldapconn, $userSearchDN, $filter, $attr);
                                                            break;
                                                        case 2:
                                                            // LDAP_SCOPE_SUBTREE search base + all subtree (OUs) below
                                                            $result = ldap_search($ldapconn, $userSearchDN, $filter, $attr);
                                                            break;
                                                        default:
                                                            // LDAP_SCOPE_BASE search base only and don't look any deeper
                                                            $result = ldap_read($ldapconn, $userSearchDN, $filter, $attr);
                                                    }
                                        
                                                    // count the number of entries returned
                                                    $retcount = ldap_count_entries($ldapconn, $result);
                                        
                                                    if ($retcount == 1) {
                                                        // great we only returned one entry
                                                        $entries = ldap_get_entries($ldapconn, $result);
                                                        // pull out the user dn from the entries
                                                        $userDN = $entries[0]['dn'];
                                                    } else {
                                                        $userDN = '';
                                                    }
                                        
                                                }
                                        
                                                // if user dn is populated then attempt to connect (bind) to ldap as user
                                                if (!$userDN =='') {
                                                    // Now rebind as the user we just found
                                                    if ( ldap_bind($ldapconn, $userDN, $pass) ) {
                                                        // If we get to here the user is authorized, now lets get the group membership
                                        
                                                        // This time since we know the user DN (fully qualified ldap path) we can look up the user based on that
                                                        // this filter just matches all objects (cheat)
                                                        $filter = '(objectclass=*)';
                                        
                                                        // get what groups this user is a member of
                                                        $attr = array( $grpMemberAttr );
                                                        
                                                        // read in the attributes of this user
                                                        $result = ldap_read($ldapconn, $userDN, $filter, $attr);
                                        
                                        
                                                        // count the number of entries returned
                                                        $retcount = ldap_count_entries($ldapconn, $result);
                                        
                                                        if ($retcount > 0) {
                                                            $entries = ldap_get_entries($ldapconn, $result);
                                        
                                                            // check groups for membership
                                                            foreach($entries[0][$grpMemberAttr] as $grps) {
                                                                // is admin user, set level and break loop
                                                                if(strpos( $grps, $adminGroup )) { $accessLevel = 2; break; }
                                        
                                                               // is user, set level and keep looking just incase user is in both groups
                                                               if(strpos( $grps, $userGroup )) $accessLevel = 1;
                                                           }
                                                        }
                                        
                                                        // close our connection as bindDN
                                                        ldap_unbind( $ldapconn );
                                        
                                                        echo $accessLevel;
                                        
                                                    } else {
                                                        print 'unable to bind using user info, user is not authorized in ldap';
                                        
                                                    }
                                             } else {
                                                  echo 'User not found in LDAP';
                                             }
                                         ?>
                                        

                                        Please help us build the FOG community with everyone involved. It's not just about coding - way more we need people to test things, update documentation and most importantly work on uniting the community of people enjoying and working on FOG!

                                        JJ FullmerJ 2 Replies Last reply Reply Quote 1
                                        • JJ FullmerJ
                                          JJ Fullmer Testers @george1421
                                          last edited by

                                          @george1421 Updated to latest rc11 and reinstalled the ldap plugin, great success.
                                          I was able to add a server no problem.

                                          Just a recommendation though, or maybe it’s a question. I figure the bindDN is the user you use to sign in to the domain and the same with the password. Perhaps it’s possible to utilize the same method or maybe even link to the existing one that fog uses for joining to the domain?
                                          Just cause it’s gonna be prone to error and confusion if to set up a binding user you have to put in that full ldap style query with the cn’s and the ou’s, and the dc’s and what have you. Or maybe I’m misunderstanding that field.

                                          Have you tried the FogApi powershell module? It's pretty cool IMHO
                                          https://github.com/darksidemilk/FogApi
                                          https://fogapi.readthedocs.io/en/latest/
                                          https://www.powershellgallery.com/packages/FogApi
                                          https://forums.fogproject.org/topic/12026/powershell-api-module

                                          george1421G 1 Reply Last reply Reply Quote 0
                                          • JJ FullmerJ
                                            JJ Fullmer Testers @george1421
                                            last edited by

                                            @george1421 Also, maybe I’m just looking in the wrong place for the documentation, so feel free to direct me to where this may already be written. But what do I do after I set up a server? Are users going to just populate automatically or is there another step? I feel like I’m missing something.

                                            Have you tried the FogApi powershell module? It's pretty cool IMHO
                                            https://github.com/darksidemilk/FogApi
                                            https://fogapi.readthedocs.io/en/latest/
                                            https://www.powershellgallery.com/packages/FogApi
                                            https://forums.fogproject.org/topic/12026/powershell-api-module

                                            george1421G 1 Reply Last reply Reply Quote 0
                                            • 1
                                            • 2
                                            • 3
                                            • 4
                                            • 1 / 4
                                            • First post
                                              Last post

                                            253

                                            Online

                                            12.0k

                                            Users

                                            17.3k

                                            Topics

                                            155.2k

                                            Posts
                                            Copyright © 2012-2024 FOG Project