Fixes #37900 - Allow syncing templates through HTTP proxy

app/controllers/api/v2/template_controller.rb

@@ -12,7 +12,9 @@ class TemplateController < ::Api::V2::BaseController
         param :repo, String, :required => false, :desc => N_("Override the default repo from settings.")
         param :filter, String, :required => false, :desc => N_("Export templates with names matching this regex (case-insensitive; snippets are not filtered).")
         param :negate, :bool, :required => false, :desc => N_("Negate the prefix (for purging).")
-        param :dirname, String, :required => false, :desc => N_("The directory within Git repo containing the templates")
+        param :dirname, String, :required => false, :desc => N_("Directory within Git repo containing the templates.")
+        param :http_proxy_policy, ForemanTemplates.http_proxy_policy_types.keys, :required => false, :desc => N_("HTTP proxy policy for template sync. If you choose 'selected', provide the `http_proxy_id` parameter.")
+        param :http_proxy_id, :number, :required => false, :desc => N_("ID of an HTTP proxy to use for template sync. Use this parameter together with `'http_proxy_policy':'selected'`")
       end
 
       api :POST, "/templates/import/", N_("Initiate Import")

app/controllers/concerns/foreman/controller/parameters/template_params.rb

@@ -7,7 +7,7 @@ module TemplateParams
 
         class_methods do
           def filter_params_list
-            %i(verbose repo branch dirname filter negate metadata_export_mode)
+            %i(verbose repo branch dirname filter negate metadata_export_mode http_proxy_policy http_proxy_id)
           end
 
           def extra_import_params

app/controllers/ui_template_syncs_controller.rb

@@ -49,6 +49,21 @@ def render_errors(messages, severity = 'danger')
   private
 
   def setting_definitions(short_names)
-    short_names.map { |name| Foreman.settings.find("template_sync_#{name}") }
+    settings = short_names.map { |name| Foreman.settings.find("template_sync_#{name}") }
+    settings << http_proxy_id_setting
+    settings
+  end
+
+  def http_proxy_id_setting
+    proxy_list = HttpProxy.authorized(:view_http_proxies).with_taxonomy_scope.each_with_object({}) { |proxy, hash| hash[proxy.id] = proxy.name }
+    default_proxy_id = proxy_list.keys.first || ""
+    OpenStruct.new(id: 'template_sync_http_proxy_id',
+      name: 'template_sync_http_proxy_id',
+      description: N_('Select an HTTP proxy to use for template sync. You can add HTTP proxies on the Infrastructure > HTTP proxies page.'),
+      settings_type: :string,
+      value: default_proxy_id,
+      default: default_proxy_id,
+      full_name: N_('HTTP proxy'),
+      select_values: proxy_list)
   end
 end

app/services/foreman_templates/action.rb

@@ -1,3 +1,5 @@
+require 'securerandom'
+
 module ForemanTemplates
   class Action
     delegate :logger, :to => :Rails
@@ -15,7 +17,7 @@ def self.repo_start_with
     end
 
     def self.setting_overrides
-      %i(verbose prefix dirname filter repo negate branch)
+      %i(verbose prefix dirname filter repo negate branch http_proxy_policy)
     end
 
     def method_missing(method, *args, &block)
@@ -53,9 +55,38 @@ def verify_path!(path)
     private
 
     def assign_attributes(args = {})
+      @http_proxy_id = args[:http_proxy_id]
       self.class.setting_overrides.each do |attribute|
         instance_variable_set("@#{attribute}", args[attribute.to_sym] || Setting["template_sync_#{attribute}".to_sym])
       end
     end
+
+    protected
+
+    def init_git_repo
+      git_repo = Git.init(@dir)
+
+      case @http_proxy_policy
+      when 'global'
+        http_proxy_url = Setting[:http_proxy]
+      when 'selected'
+        http_proxy = HttpProxy.authorized(:view_http_proxies).with_taxonomy_scope.find(@http_proxy_id)
+        http_proxy_url = http_proxy.full_url
+
+        if URI(http_proxy_url).scheme == 'https' && http_proxy.cacert.present?
+          proxy_cert = "#{@dir}/.git/foreman_templates_proxy_cert_#{SecureRandom.hex(8)}.crt"
+          File.write(proxy_cert, http_proxy.cacert)
+          git_repo.config('http.proxySSLCAInfo', proxy_cert)
+        end
+      end
+
+      if http_proxy_url.present?
+        git_repo.config('http.proxy', http_proxy_url)
+      end
+
+      git_repo.add_remote('origin', @repo)
+      logger.debug "cloned '#{@repo}' to '#{@dir}'"
+      git_repo
+    end
   end
 end

app/services/foreman_templates/template_exporter.rb

@@ -31,8 +31,8 @@ def export_to_git
       @dir = Dir.mktmpdir
       return if branch_missing?
 
-      git_repo = Git.clone(@repo, @dir)
-      logger.debug "cloned '#{@repo}' to '#{@dir}'"
+      git_repo = init_git_repo
+      git_repo.fetch
 
       setup_git_branch git_repo
       dump_files!

app/services/foreman_templates/template_importer.rb

@@ -32,9 +32,9 @@ def import_from_git
       @dir = Dir.mktmpdir
 
       begin
-        logger.debug "cloned '#{@repo}' to '#{@dir}'"
-        gitrepo = Git.clone(@repo, @dir)
-        if @branch
+        gitrepo = init_git_repo
+        gitrepo.fetch
+        if @branch.present?
           logger.debug "checking out branch '#{@branch}'"
           gitrepo.checkout(@branch)
         end

lib/foreman_templates.rb

@@ -1,7 +1,7 @@
 require 'foreman_templates/engine'
 
 module ForemanTemplates
-  BASE_SETTING_NAMES = %w(repo branch dirname filter negate).freeze
+  BASE_SETTING_NAMES = %w(repo branch dirname filter negate http_proxy_policy).freeze
   IMPORT_SETTING_NAMES = (BASE_SETTING_NAMES | %w(prefix associate force lock)).freeze
   EXPORT_SETTING_NAMES = (BASE_SETTING_NAMES | %w(metadata_export_mode commit_msg)).freeze
 
@@ -16,4 +16,8 @@ def self.lock_types
   def self.metadata_export_mode_types
     { 'refresh' => _('Refresh'), 'keep' => _('Keep'), 'remove' => _('Remove') }
   end
+
+  def self.http_proxy_policy_types
+    { 'global' => _('Global default HTTP proxy'), 'none' => _('No HTTP proxy'), 'selected' => _('Custom HTTP proxy') }
+  end
 end

lib/foreman_templates/engine.rb

@@ -94,6 +94,12 @@ class Engine < ::Rails::Engine
               description: N_('Custom commit message for templates export'),
               default: 'Templates export made by a Foreman user',
               full_name: N_('Commit message'))
+            setting('template_sync_http_proxy_policy',
+              type: :string,
+              description: N_('Should an HTTP proxy be used for template sync? If you select Custom HTTP proxy, you will be prompted to select one when syncing templates.'),
+              default: 'global',
+              full_name: N_('HTTP proxy policy'),
+              collection: -> { ForemanTemplates.http_proxy_policy_types })
           end
         end
 

test/unit/action_test.rb

@@ -85,5 +85,75 @@ class ActionTest < ActiveSupport::TestCase
         end
       end
     end
+
+    context 'sync through http_proxy' do
+      before do
+        @template_sync_service = Action.new(:repo => 'https://github.com/theforeman/community-templates.git')
+      end
+
+      test 'should sync through custom http proxy' do
+        proxy = FactoryBot.create(:http_proxy)
+        @template_sync_service.instance_variable_set(:@http_proxy_policy, 'selected')
+        @template_sync_service.instance_variable_set(:@http_proxy_id, proxy.id)
+        assert_equal proxy.full_url, show_repo_proxy_url
+      end
+
+      test 'sync should fail if invalid http proxy id is provided' do
+        @template_sync_service.instance_variable_set(:@http_proxy_policy, 'selected')
+        @template_sync_service.instance_variable_set(:@http_proxy_id, 'invalid ID')
+        assert_raises(ActiveRecord::RecordNotFound) do
+          @template_sync_service.send(:init_git_repo)
+        end
+      end
+
+      test 'should sync through https proxy using custom CA certificate' do
+        custom_cert = 'Custom proxy CA cert'
+        proxy = FactoryBot.create(:http_proxy, :cacert => custom_cert, :url => 'https://localhost:8888')
+        @template_sync_service.instance_variable_set(:@http_proxy_policy, 'selected')
+        @template_sync_service.instance_variable_set(:@http_proxy_id, proxy.id)
+        assert_equal custom_cert, show_repo_proxy_cert
+      end
+
+      test 'should sync through global http proxy' do
+        Setting[:http_proxy] = 'https://localhost:8888'
+        @template_sync_service.instance_variable_set(:@http_proxy_policy, 'global')
+        assert_equal Setting[:http_proxy], show_repo_proxy_url
+      end
+
+      test 'should sync without using http proxy if global proxy is not set' do
+        Setting[:http_proxy] = ""
+        @template_sync_service.instance_variable_set(:@http_proxy_policy, 'global')
+        assert_nil show_repo_proxy_url
+      end
+
+      test 'should sync without using http proxy' do
+        @template_sync_service.instance_variable_set(:@http_proxy_policy, 'none')
+        assert_nil show_repo_proxy_url
+      end
+
+      private
+
+      def show_repo_proxy_url
+        dir = Dir.mktmpdir
+        @template_sync_service.instance_variable_set(:@dir, dir)
+        begin
+          repo = @template_sync_service.send(:init_git_repo)
+          repo.config.to_h['http.proxy']
+        ensure
+          FileUtils.remove_entry_secure(dir) if File.exist?(dir)
+        end
+      end
+
+      def show_repo_proxy_cert
+        dir = Dir.mktmpdir
+        @template_sync_service.instance_variable_set(:@dir, dir)
+        begin
+          repo = @template_sync_service.send(:init_git_repo)
+          File.read(repo.config('http.proxysslcainfo'))
+        ensure
+          FileUtils.remove_entry_secure(dir) if File.exist?(dir)
+        end
+      end
+    end
   end
 end

webpack/components/NewTemplateSync/components/NewTemplateSyncForm/NewTemplateSyncFormHelpers.js

@@ -1,4 +1,6 @@
 import * as Yup from 'yup';
+import React from 'react';
+import { translate as __ } from 'foremanReact/common/I18n';
 
 export const redirectToResult = history => () =>
   history.push({ pathname: '/template_syncs/result' });
@@ -15,6 +17,9 @@ const repoFormat = formatAry => value => {
   return value && valid;
 };
 
+const httpProxyAvailable = proxyId => value =>
+  value !== 'selected' || proxyId.value !== '';
+
 export const syncFormSchema = (syncType, settingsObj, validationData) => {
   const schema = (settingsObj[syncType].asMutable() || []).reduce(
     (memo, setting) => {
@@ -24,14 +29,30 @@ export const syncFormSchema = (syncType, settingsObj, validationData) => {
           repo: Yup.string()
             .test(
               'repo-format',
-              `Invalid repo format, must start with one of: ${validationData.repo.join(
-                ', '
-              )}`,
+              `${__(
+                'Invalid repo format, must start with one of: '
+              )}${validationData.repo.join(', ')}`,
               repoFormat(validationData.repo)
             )
             .required("can't be blank"),
         };
       }
+      if (setting.name === 'http_proxy_policy') {
+        return {
+          ...memo,
+          http_proxy_policy: Yup.mixed().test(
+            'http-proxy-available',
+            __(
+              'No HTTP proxies available. Please select a different policy or verify that you have selected the correct organization and location.'
+            ),
+            httpProxyAvailable(
+              settingsObj[syncType].find(
+                obj => obj.id === 'template_sync_http_proxy_id'
+              )
+            )
+          ),
+        };
+      }
       return memo;
     },
     {}
@@ -41,3 +62,13 @@ export const syncFormSchema = (syncType, settingsObj, validationData) => {
     [syncType]: Yup.object().shape(schema),
   });
 };
+
+export const tooltipContent = setting => (
+  <div
+    dangerouslySetInnerHTML={{
+      __html: __(setting.description),
+    }}
+  />
+);
+
+export const label = setting => `${__(setting.fullName)}`;

webpack/components/NewTemplateSync/components/ProxySettingField.js

@@ -0,0 +1,44 @@
+import React from 'react';
+import PropTypes from 'prop-types';
+import { get } from 'lodash';
+
+import { FieldLevelHelp } from 'patternfly-react';
+import RenderField from './TextButtonField/RenderField';
+import ButtonTooltip from './ButtonTooltip';
+
+import {
+  tooltipContent,
+  label,
+} from './NewTemplateSyncForm/NewTemplateSyncFormHelpers';
+
+const ProxySettingField = ({ setting, resetField, field, form, fieldName }) => (
+  <RenderField
+    label={label(setting)}
+    fieldSelector={_ => 'select'}
+    tooltipHelp={<FieldLevelHelp content={tooltipContent(setting)} />}
+    buttonAttrs={{
+      buttonText: <ButtonTooltip tooltipId={fieldName} />,
+      buttonAction: () =>
+        resetField(fieldName, setting.value)(form.setFieldValue),
+    }}
+    blank={{}}
+    item={setting}
+    disabled={false}
+    fieldRequired
+    meta={{
+      touched: get(form.touched, fieldName),
+      error: get(form.errors, fieldName),
+    }}
+    input={field}
+  />
+);
+
+ProxySettingField.propTypes = {
+  setting: PropTypes.object.isRequired,
+  resetField: PropTypes.func.isRequired,
+  field: PropTypes.object.isRequired,
+  form: PropTypes.object.isRequired,
+  fieldName: PropTypes.string.isRequired,
+};
+
+export default ProxySettingField;