xenadmin/XenAdmin/Core/Registry.cs

/* Copyright (c) Citrix Systems Inc. 
 * All rights reserved. 
 * 
 * Redistribution and use in source and binary forms, 
 * with or without modification, are permitted provided 
 * that the following conditions are met: 
 * 
 * *   Redistributions of source code must retain the above 
 *     copyright notice, this list of conditions and the 
 *     following disclaimer. 
 * *   Redistributions in binary form must reproduce the above 
 *     copyright notice, this list of conditions and the 
 *     following disclaimer in the documentation and/or other 
 *     materials provided with the distribution. 
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND 
 * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, 
 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR 
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 
 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 
 * SUCH DAMAGE.
 */

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Win32;

namespace XenAdmin.Core
{
    public class Registry
    {
        private static readonly log4net.ILog log = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

        internal static bool AllowCredentialSave
        {
            get
            {
                return ReadBool(ALLOW_CREDENTIAL_SAVE, true);
            }
        }

        internal static bool VMPRFeatureEnabled
        {
            get
            {
                return ReadBool(VMPR_ENABLED, true);
            }
        }

        internal static bool DisablePlugins
        {
            get
            {
                return ReadBool(DISABLE_PLUGINS, false);
            }
        }

        internal static bool ForceSystemFonts
        {
            get
            {
                return ReadBool(FORCE_SYSTEM_FONTS, false);
            }
        }

        internal static bool DontSudo
        {
            get
            {
                return ReadBool(DONT_SUDO, false);  // CA-38045
            }
        }

        public static SSLCertificateTypes AlwaysShowSSLCertificates
        {
            get
            {
                try
                {
                    RegistryKey masterKey = Microsoft.Win32.Registry.LocalMachine.OpenSubKey(XENCENTER_LOCAL_KEYS);
                    if (masterKey == null)
                        return SSLCertificateTypes.None;

                    try
                    {
                        object v = masterKey.GetValue(SSL_CERTIFICATES_KEY);
                        if (v != null)
                        {
                            if (v.ToString().ToUpperInvariant() == SSL_CERTIFICATES_CHANGED_ONLY)
                                return SSLCertificateTypes.Changed;

                            if (v.ToString().ToUpperInvariant() == SSL_CERTIFICATES_ALL)
                                return SSLCertificateTypes.All;
                        }
                        return SSLCertificateTypes.None;
                    }
                    finally
                    {
                        masterKey.Close();
                    }
                }
                catch
                {
                    return SSLCertificateTypes.None;
                }
            }
        }

        public static bool IsPowerShellInstalled()
        {
            try
            {
                RegistryKey masterKey = Microsoft.Win32.Registry.LocalMachine.OpenSubKey(PowerShellKey);
                if (masterKey == null)
                    return false;

                try
                {
                    object v = masterKey.GetValue(PowerShellStamp);
                    if (v != null && v is int && (int)v == 1)
                            return true;
                    return false;
                }
                finally
                {
                    masterKey.Close();
                }
            }
            catch (Exception e)
            {
                log.Debug("It looks like PowerShell is not installed on your machine!", e);
            }
            return false;
        }

        public static bool IsXenServerSnapInInstalled()
        {
            return !string.IsNullOrEmpty(XenServerSnapInLocation());
        }

        public static bool IsExecutionPolicyNotRestricted()
        {
            return PowerShellExecutionPolicy() != "Restricted";
        }

        public static string XenServerSnapInLocation()
        {
            try
            {
                RegistryKey masterKey = Microsoft.Win32.Registry.LocalMachine.OpenSubKey(PSConsoleKey);
                if (masterKey == null)
                {
                    masterKey = Microsoft.Win32.Registry.CurrentUser.OpenSubKey(PSConsoleKey);
                    if (masterKey == null)
                    {
                        return "";
                    }
                }

                try
                {
                    object v = masterKey.GetValue(PSConsoleName);
                    if (v != null)
                        return v.ToString();
                    return "";
                }
                finally
                {
                    masterKey.Close();
                }
            }
            catch (Exception e)
            {
                log.Debug("Failed to find XenServerPSSnapIn Console file. Assuming the XenServerPSSnapIn is not installed.", e);
            }
            return "";
        }

        public static string PowerShellExecutionPolicy()
        {
            try
            {
                RegistryKey masterKey = Microsoft.Win32.Registry.LocalMachine.OpenSubKey(PSExecutionPolicyKey);
                if (masterKey == null)
                {
                    masterKey = Microsoft.Win32.Registry.CurrentUser.OpenSubKey(PSExecutionPolicyKey);
                    if (masterKey == null)
                    {
                        return "";
                    }
                }

                try
                {
                    object v = masterKey.GetValue(PSExecutionPolicyName);
                    if (v != null)
                        return v.ToString();
                    return "";
                }
                finally
                {
                    masterKey.Close();
                }
            }
            catch (Exception e)
            {
                log.Debug("Failed to find XenServerPSSnapIn Console file. Assuming the XenServerPSSnapIn is not installed.", e);
            }
            return "";
        }

        public static void CheckPowershell()
        {
            if (!Registry.IsPowerShellInstalled())
                throw new I18NException(I18NExceptionType.PowerShellNotPresent);

        }

        public static void CheckXenServerPSSnapIn()
        {
            CheckPowershell();

            if (!Registry.IsXenServerSnapInInstalled())
                throw new I18NException(I18NExceptionType.PowerShellSnapInNotPresent);
            
            if (!Registry.IsExecutionPolicyNotRestricted())
                throw new I18NException(I18NExceptionType.PowerShellExecutionPolicyRestricted);
        }

        /// <summary>
        /// Read a true/false key from XENCENTER_LOCAL_KEYS\k.
        /// </summary>
        /// <returns>False if the value is "false" (case insensitive), true if the key is present but not
        /// "false", def otherwise.</returns>
        private static bool ReadBool(string k, bool def)
        {
            try
            {
                RegistryKey masterKey = Microsoft.Win32.Registry.LocalMachine.OpenSubKey(XENCENTER_LOCAL_KEYS);
                if (masterKey == null)
                    return def;

                try
                {
                    object v = masterKey.GetValue(k);
                    if (v == null)
                        return def;
                    else
                        return "FALSE" != v.ToString().ToUpperInvariant();
                }
                finally
                {
                    masterKey.Close();
                }
            }
            catch (Exception e)
            {
                log.DebugFormat(@"Failed to read {0}\{1} from registry; assuming {1} is {2}.", XENCENTER_LOCAL_KEYS, k, def);
                log.Debug(e, e);
                return def;
            }
        }

        /// <summary>
        /// Reads a key from XENCENTER_LOCAL_KEYS\k.
        /// </summary>
        private static string ReadKey(string k)
        {
            try
            {
                RegistryKey masterKey = Microsoft.Win32.Registry.LocalMachine.OpenSubKey(XENCENTER_LOCAL_KEYS);
                if (masterKey == null)
                    return null;

                try
                {
                    var v = masterKey.GetValue(k);
                    return (v != null) ? v.ToString() : null;
                }
                finally
                {
                    masterKey.Close();
                }
            }
            catch (Exception e)
            {
                log.DebugFormat(@"Failed to read {0}\{1} from registry; assuming NULL.", XENCENTER_LOCAL_KEYS, k);
                log.Debug(e, e);
                return null;
            }
        }

        public static string CallHomeIdentityTokenDomainName
        {
            get { return ReadKey(CALL_HOME_IDENTITY_TOKEN_DOMAIN_NAME); }
        }

        public static string CallHomeUploadTokenDomainName
        {
            get { return ReadKey(CALL_HOME_UPLOAD_TOKEN_DOMAIN_NAME); }
        }

        public static string CallHomeUploadGrantTokenDomainName
        {
            get { return ReadKey(CALL_HOME_UPLOAD_GRANT_TOKEN_DOMAIN_NAME); }
        }

        private const string SSL_CERTIFICATES_CHANGED_ONLY = "CHANGED";
        private const string SSL_CERTIFICATES_ALL = "ALL";
        private const string SSL_CERTIFICATES_KEY = "ForceSSLCertificates";
        private const string ALLOW_CREDENTIAL_SAVE = "AllowCredentialSave";
        private const string FORCE_SYSTEM_FONTS = "ForceSystemFonts";
        private const string DISABLE_PLUGINS = "DisablePlugins";
        private const string VMPR_ENABLED = "VMPREnabled";
        private const string DONT_SUDO = "DontSudo";
        private const string XENCENTER_LOCAL_KEYS = @"SOFTWARE\Citrix\XenCenter";
        private const string PSConsoleKey = @"Software\Citrix\XenServerPSSnapIn";
        private const string PSConsoleName = "ConsoleFile";
        private const string PSExecutionPolicyKey = @"Software\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell";
        private const string PSExecutionPolicyName = "ExecutionPolicy";
        private const string PowerShellKey = @"Software\Microsoft\PowerShell\1";
        private const string PowerShellStamp = "Install";
        private const string CALL_HOME_IDENTITY_TOKEN_DOMAIN_NAME = "CallHomeIdentityTokenDomainName";
        private const string CALL_HOME_UPLOAD_TOKEN_DOMAIN_NAME = "CallHomeUploadTokenDomainName";
        private const string CALL_HOME_UPLOAD_GRANT_TOKEN_DOMAIN_NAME = "CallHomeUploadGrantTokenDomainName";
    }

    public enum SSLCertificateTypes { None, Changed, All }
}