Contents

# frozen_string_literal: true

# Released under the MIT License.
# Copyright, 2018-2023, by Samuel Williams.

require 'async/http/endpoint'
require 'localhost/authority'

module Falcon
	# An HTTP-specific endpoint which adds localhost TLS.
	class Endpoint < Async::HTTP::Endpoint
		# The SSL context to use, which invokes {build_ssl_context} if not otherwise specified.
		# @returns [OpenSSL::SSL::SSLContext]
		def ssl_context
			@options[:ssl_context] || build_ssl_context
		end
		
		# Build an appropriate SSL context for the given hostname.
		#
		# Uses {Localhost::Authority} to generate self-signed certficates.
		#
		# @returns [OpenSSL::SSL::SSLContext]
		def build_ssl_context(hostname = self.hostname)
			authority = Localhost::Authority.fetch(hostname)
			
			authority.server_context.tap do |context|
				context.alpn_select_cb = lambda do |protocols|
					if protocols.include? "h2"
						return "h2"
					elsif protocols.include? "http/1.1"
						return "http/1.1"
					elsif protocols.include? "http/1.0"
						return "http/1.0"
					else
						return nil
					end
				end
				
				context.session_id_context = "falcon"
			end
		end
	end
end

Version data entries

17 entries across 17 versions & 1 rubygems

Version	Path
falcon-0.48.3	lib/falcon/endpoint.rb
falcon-0.48.2	lib/falcon/endpoint.rb
falcon-0.48.1	lib/falcon/endpoint.rb
falcon-0.48.0	lib/falcon/endpoint.rb
falcon-0.47.10	lib/falcon/endpoint.rb
falcon-0.47.9	lib/falcon/endpoint.rb
falcon-0.47.8	lib/falcon/endpoint.rb
falcon-0.47.7	lib/falcon/endpoint.rb
falcon-0.47.1	lib/falcon/endpoint.rb
falcon-0.47.0	lib/falcon/endpoint.rb
falcon-0.46.1	lib/falcon/endpoint.rb
falcon-0.46.0	lib/falcon/endpoint.rb
falcon-0.45.2	lib/falcon/endpoint.rb
falcon-0.45.1	lib/falcon/endpoint.rb
falcon-0.45.0	lib/falcon/endpoint.rb
falcon-0.44.0	lib/falcon/endpoint.rb
falcon-0.43.0	lib/falcon/endpoint.rb