FOG/Apache PKI/Certificate Authentication


  • Senior Developer

    @ty900000 said in FOG/Apache PKI/Certificate Authentication:

    I had to reboot FOG complete, restarting httpd didn’t seem to work too well.

    That sounds kinda strange. What command did you use?

    I don’t plan on using the FOG-Client right now, so I am not too worried about that.

    All fine then for now.

    When I selected the cert, it did move me along to the normal login page, which I would expect since it’s not doing anything with the cert yet. Now, I am just not sure what to do with the information I can glean from the certificate?

    Well done! Now that you’ve done the easy part you/we need to start looking at the PHP code. You want to start looking at this here: https://github.com/FOGProject/fogproject/blob/dev-branch/packages/web/lib/plugins/ldap/hooks/ldappluginhook.hook.php#L101



  • @Sebastian-Roth said in FOG/Apache PKI/Certificate Authentication:

    Be aware that you cannot use the current fog-client as it is using your own CA.

    Apologies for the double post - I didn’t see you had posted until after I refreshed the page. I don’t plan on using the FOG-Client right now, so I am not too worried about that.



  • I did manage to get the FOG site to prompt me for a certificate. From that website you sent, I added to fog.conf:

    SSLVerifyClient require
    SSLVerifyDepth 1
    SSLOptions +StdEnvVars
    

    I also then added the following line to that file

    SSLCACertificateFile </full/path/to/CA/cert.pem>
    

    I had to reboot FOG complete, restarting httpd didn’t seem to work too well. It did prompt me for a certificate (which needs Client Authentication at a minimum). When I selected the cert, it did move me along to the normal login page, which I would expect since it’s not doing anything with the cert yet. Now, I am just not sure what to do with the information I can glean from the certificate?

    Thanks again for the assistance!!


  • Senior Developer

    @ty900000 said in FOG/Apache PKI/Certificate Authentication:

    I had to modify the functions.sh script to stop doing that.

    When you first said something about modifying functions.sh I was thinking if you really mean you use your own CA. Wasn’t sure though. Good to know! Be aware that you cannot use the current fog-client as it is using your own CA. I will be working on this but it’s a long way down the road to fully change this. If you are still keen to make it work you can compile your personal fog-client installer binary and use that instead till we have a solution ready for everyone. Let me know if you want to use the fog-client.

    I’ll see if I can incorporate that to at least prompt for a certificate.

    That shouldn’t be hard to do at all. Though grabbing and using the cert information in PHP to allow access to the web UI is still a fair work away.



  • @Sebastian-Roth said in FOG/Apache PKI/Certificate Authentication:

    Not sure if you are aware of the installing having a command line switch forcing it to setup FOG with HTTPS?! Run ./installfog.sh --force-https and it should generate the right Apache config for you as well as compile iPXE binaries with the CA cert to trust included.

    Haha! Yes, I did see FOG supports generating its own certificates. I had to modify the functions.sh script to stop doing that. I wanted to use my own Windows CA and its template so the FOG certificate would be trusted by other clients on the domain automatically - no self-signed certs.

    The last command will ask you for certificate details like country code and most importantly Common Name (CN) and Email Address.

    I did create a certificate with the CN as the FQDN of the FOG server before I passed it on to the CA for approval and issuing. It does not have an email though, since it is a server and not a user. If what you say about PHP using the CN is feasible, my certificate should be good to go. I can always request a new certificate with different fields, if it comes to that.

    I’ll take a look at that website, too. Thanks for sending that over. I’ll see if I can incorporate that to at least prompt for a certificate. Would that be a good idea, you think?

    Thanks again for the assistance!


  • Senior Developer

    @ty900000 said in FOG/Apache PKI/Certificate Authentication:

    I did manage to get the FOG and the CA certificate installed and functional. It took a little rewriting of the functions.sh. This made HTTPS work properly, too

    Not sure if you are aware of the installing having a command line switch forcing it to setup FOG with HTTPS?! Run ./installfog.sh --force-https and it should generate the right Apache config for you as well as compile iPXE binaries with the CA cert to trust included.

    @george1421 Thanks heaps for your comment on this. Neither have I been involved in developing the LDAP plugin nor have I used it myself yet. I wasn’t aware of the point that a user account is needed. From what you said I would think PKI authentication would need to be added as a plugin just as well. Probably the LDAP plugin is a good start.

    There is some good information on how to grab the client certificate information within PHP (and also what is needed on the Apache side again): https://cweiske.de/tagebuch/ssl-client-certificates.htm

    Now to start off you’d generate at least one client certificate:

    sudo -i
    cd /opt/fog/snapins/ssl
    openssl genrsa -out user1.key 4096
    openssl req -new -sha512 -key user1.key -out user1.csr
    

    The last command will ask you for certificate details like country code and most importantly Common Name (CN) and Email Address. Those two could be important later on in the PHP code.

    Next step: Sign the certificate request using the FOG server CA.

    openssl x509 -req -in user1.csr -CA ./CA/.fogCA.pem -CAkey ./CA/.fogCA.key -CAcreateserial -out user1.crt -days 3650
    

    You end up with a PEM certificate in user1.crt that should be importable in Firefox and other browsers.



  • I did manage to get the FOG and the CA certificate installed and functional. It took a little rewriting of the functions.sh. This made HTTPS work properly, too.

    However (and I figured this would happen), iPXE does not work. When it attempts to use the HTTPS site, it throws an error (http://ipxe.org/err/3e1161). Says DNS isn’t happy. That does not appear to be accurate. When I hop in the iPXE shell, and do a ‘show dns’ it returns the correct DNS server. And when I ping, by name, the FOG server, it succeeds. So, I’m not sure why iPXE is complaining about that. I did figure out that if I disable the HTTPS rewrite on Apache and change the iPXE chain to use the normal HTTP site, iPXE does begin to work. This, of course, allows browsing to the normal HTTP FOG site - not super great. Deploying an image works, too.

    Don’t know if any of this helps out.



  • @george1421 said in FOG/Apache PKI/Certificate Authentication:

    The issue is that FOG needs a named user in its local database for authentication.

    Hmmm… okay. I wonder if it would it be possible to pull the alternate name from the certificate offered to be temporarily added to the FOG database. And then if that alternate name is part of an LDAP group, that user would be allowed to log into FOG. I don’t know, just throwing some stuff out there. I know this isn’t functionality that very many people are looking for, if any. Either way, I truly appreciate the assistance and support.


  • Moderator

    @ty900000 said in FOG/Apache PKI/Certificate Authentication:

    Would it be possible to log into FOG using PKI certificates, rather than the local database or LDAP?

    Since I worked on the ldap plugin for fog back in the day, I’m going to say no, unless someone creates a custom plugin. The issue is that FOG needs a named user in its local database for authentication. What was done in the ldap plugin is when a successful ldap authentication was created a temporary user was created in the fog user database. Authentication was done by ldap, but internally with FOG there was a named user in the database. Understand the ldap plugin has been improved since I was working with it, but back then this is how we got around a few issues.

    It may be possible to use the ldap plugin as a template for the pki certificate authentication, I simply don’t know. But (IMO) it will take a bit more than just making apache happy.


  • Senior Developer

    @ty900000 I will have a bit of time to play with this over the weekend.



  • @Sebastian-Roth Yes, sir. I’d like to give it a shot. And I did read over that link - thanks for providing it!

    I generated a certificate using a request file on my FOG server just this evening. I got the certificate how I’d like it, with all the necessary alternate names and all that, and got it issued from my Windows CA using a template I created for *Nix-based devices. I copied the cer (PEM) certificate over to the FOG server for use. I also have the key from when I created the CSR (I am assuming that is the key file needed for the actual PEM certificate. If not, please forgive my ignorance).

    I went ahead a little and tried to put the PEM and key in the right locations - /var/www/html/fog/managment/other/ssl and /opt/fog/snapins/ssl directories. I think those are right? When I run the installfog.sh script with -S to force HTTPS, I notice the script automatically recreates the keys and PEM for both the FOG self-signed cert and the CA cert and deletes the stuff I put in there and then Apache freaks out.

    I Googled for FOG with SSL and only really got this forum post: https://forums.fogproject.org/topic/12095/web-interface-ssl/

    Doesn’t look like it got very far for external CA certs, though.

    Thanks very much for the assistance! I really appreciate it!


  • Senior Developer

    @ty900000 I don’t think anyone has tried this before but I am sure it can be done. It’s not as straight forward as one might think because it’s not just the web UI accessed by the browser but also PXE booting clients and the fog-client sending requests to the webserver.

    If you are keen to give it a try we can support you to make it work.

    Start reading here: https://stuff-things.net/2015/09/28/configuring-apache-for-ssl-client-certificate-authentication/

    I’ll try to give you more details on how to generate the certificates on you FOG server tomorrow.


Log in to reply
 

313
Online

7.2k
Users

14.4k
Topics

135.6k
Posts