Difference between revisions of "FOG Client"
m (→Security design: typo correction.) |
(→Maintain Control of hosts when building new server) |
||
Line 53: | Line 53: | ||
* <font color="red">/opt/fog/snapins/CA</font> | * <font color="red">/opt/fog/snapins/CA</font> | ||
+ | |||
+ | Copy them to a temporary location first. I would suggest /root/ | ||
+ | |||
+ | Next, install fog. After the installation is complete, delete the CA and ssl folders the installer made, and place your old ones in there. the ownership should be fog:apache on redhat variants, should be fog:www-data on ubuntu. Then re-run the installer. | ||
If you do not care about maintaining control of existing hosts with existing new fog client deployments (because there is only 1 or 2), you can recreate your CA with the -C argument during installation: | If you do not care about maintaining control of existing hosts with existing new fog client deployments (because there is only 1 or 2), you can recreate your CA with the -C argument during installation: |
Revision as of 17:58, 5 February 2016
Article under construction - below you will find notes / gibberish that has slowly been collected to make an article out of.
Be thoughtful and only use what you need. Feel free to ask questions in the forums.
Contents
New FOG Client 0.9.9+
Security design
Communications between the FOG Client (0.9.9+) and the FOG Server (1.3.0+) are secured with SSL.
A CA and certificate is generated on the FOG server during installation in these locations:
/opt/fog/snapins/CA /opt/fog/snapins/ssl
The public certificate is generally located here:
/var/www/html/fog/management/other/ssl
The client installs your servers’ certificate and the FOG Project certificate.
The “FOG Project” CA (made by the FOG Project) serves two purposes:
- SYSTEM level services need to be digitally signed otherwise windows will throw security errors. This can also be used to ensure no tampering was done with the client files
- That certificate is used to “verify” upgrades. Lets say we release a patch for the client, the client will download the MSI from your server and check if it was signed by us. If the MSI was somehow tampered, the digital signature would no longer be valid.
Using HTTP over HTTPS has no security benefit to the client. Why? Because all traffic is already encrypted. Here’s a very basic overview of how the new client communicates
- Each client has a security token. This is used to prove to the server that the client is the actual host and not an impersonator. This token gets cycled constantly. When the client first makes contact, it encrypts its token and a proposed AES 256 key using RSA 4096 using your server’s public key. This public key is verified against the pinned server CA certificate by checking the x509 chain and fingerprints.
- If the server accepts the security token and the new AES key, all traffic from that point on is AES 256 encrypted using that securely transmitted key.
The whole point of our security model is to allow for secure communication over insecure medians. Even then, the client installation has an HTTPS option, but it serves no real security benefit.
References:
Certificate and Public Key Pinning
Transport_Layer_Protection_Cheat_Sheet
Maintain Control of hosts when building new server
Because of the security model of FOG 1.3.0 and the new client, without the proper CA and ssl certificates present on a new fog server, any currently deployed hosts with the new fog client installed will ignore the new server and not accept commands from it. This is by design.
In order to maintain control of existing hosts with existing new fog client deployments, you must copy these two directories from the old server to the new server:
- /opt/fog/snappins/ssl
- /opt/fog/snapins/CA
Copy them to a temporary location first. I would suggest /root/
Next, install fog. After the installation is complete, delete the CA and ssl folders the installer made, and place your old ones in there. the ownership should be fog:apache on redhat variants, should be fog:www-data on ubuntu. Then re-run the installer.
If you do not care about maintaining control of existing hosts with existing new fog client deployments (because there is only 1 or 2), you can recreate your CA with the -C argument during installation:
./installfog.sh -C
Please note that recreating the CA is very strongly advised against if you have many clients deployed already.
FOG Client 0.9.9+ Installation options
msiexec /i FOGService.msi /quiet USETRAY="0" HTTPS="0" WEBADDRESS="192.168.1.X" WEBROOT="/fog" ROOTLOG="0"
Firstly, all options are optional. Here’s what they all do:
- USETRAY: defaults to "1", if "0" the tray will be hidden
- HTTPS: defaults to "0", if "1" the client will use HTTPS (not recommended)
- WEBADDRESS: defaults to "fog-server", this is the ip/dns name of your server
- WEBROOT: defaults to "/fog"
- ROOTLOG defaults to "0", if "1" the fog.log will be at C:\fog.log, otherwise %PROGRAMFILES%\FOG\fog.log
Reference: MSI Silent Install without Tray Icon
Manually reset encryption on ALL hosts
This applies to FOG 1.3.0 where the New Client is in use and for some reason you need to manually reset the encryption for all hosts.
mysql use fog UPDATE hosts SET hostPubKey="", hostSecToken="", hostSecTime="0000-00-00 00:00:00";