module Puppet::Network::HttpPool

This module contains the factory methods that should be used for getting a {Puppet::Network::HTTP::Connection} instance. The pool may return a new connection or a persistent cached connection, depending on the underlying pool implementation in use.

@api public

Public Class Methods

http_client_class() click to toggle source

# File lib/puppet/network/http_pool.rb, line 16
def self.http_client_class
  @http_client_class
end

http_client_class=(klass) click to toggle source

# File lib/puppet/network/http_pool.rb, line 19
def self.http_client_class=(klass)
  @http_client_class = klass
end

http_instance(host, port, use_ssl = true, verify_peer = true) click to toggle source

Retrieve a connection for the given host and port.

@param host [String] The hostname to connect to @param port [Integer] The port on the host to connect to @param use_ssl [Boolean] Whether to use an SSL connection @param verify_peer [Boolean] Whether to verify the peer credentials, if possible. Verification will not take place if the CA certificate is missing. @return [Puppet::Network::HTTP::Connection]

@api public

# File lib/puppet/network/http_pool.rb, line 33
def self.http_instance(host, port, use_ssl = true, verify_peer = true)
  verifier = if verify_peer
               Puppet::SSL::Validator.default_validator()
             else
               Puppet::SSL::Validator.no_validator()
             end

  http_client_class.new(host, port,
                          :use_ssl => use_ssl,
                          :verify => verifier)
end

http_ssl_instance(host, port, verifier = Puppet::SSL::Validator.default_validator()) click to toggle source

Get an http connection that will be secured with SSL and have the connection verified with the given verifier

@param host [String] the DNS name to connect to @param port [Integer] the port to connect to @param verifier [setup_connection, peer_certs, verify_errors] An object that will setup the appropriate

verification on a Net::HTTP instance and report any errors and the certificates used.

@return [Puppet::Network::HTTP::Connection]

@api public

# File lib/puppet/network/http_pool.rb, line 56
def self.http_ssl_instance(host, port, verifier = Puppet::SSL::Validator.default_validator())
  http_client_class.new(host, port,
                          :use_ssl => true,
                          :verify => verifier)
end