Class: OpenSSL::SSL::SSLServer

Inherits:
Object
  • Object
show all
Includes:
SocketForwarder
Defined in:
lib/jopenssl21/openssl/ssl.rb,
lib/jopenssl18/openssl/ssl-internal.rb,
lib/jopenssl19/openssl/ssl-internal.rb

Overview

SSLServer represents a TCP/IP server socket with Secure Sockets Layer.

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from SocketForwarder

#addr, #closed?, #do_not_reverse_lookup=, #fcntl, #getsockopt, #peeraddr, #setsockopt

Constructor Details

#initialize(svr, ctx) ⇒ SSLServer

Creates a new instance of SSLServer.

  • srv is an instance of TCPServer.

  • ctx is an instance of OpenSSL::SSL::SSLContext.



158
159
160
161
162
163
164
165
166
167
168
 
# File 'lib/jopenssl21/openssl/ssl.rb', line 158

def initialize(svr, ctx)
  @svr = svr
  @ctx = ctx
  unless ctx.session_id_context
    # see #6137 - session id may not exceed 32 bytes
    prng = ::Random.new($0.hash)
    session_id = prng.bytes(16).unpack('H*')[0]
    @ctx.session_id_context = session_id
  end
  @start_immediately = true
end

Instance Attribute Details

#start_immediately ⇒ Object

When true then #accept works exactly the same as TCPServer#accept



153
154
155
 
# File 'lib/jopenssl21/openssl/ssl.rb', line 153

def start_immediately
  @start_immediately
end

Instance Method Details

#accept ⇒ Object

Works similar to TCPServer#accept.



186
187
188
189
190
191
192
193
194
195
196
197
 
# File 'lib/jopenssl21/openssl/ssl.rb', line 186

def accept
  sock = @svr.accept
  begin
    ssl = OpenSSL::SSL::SSLSocket.new(sock, @ctx)
    ssl.sync_close = true
    ssl.accept if @start_immediately
    ssl
  rescue SSLError => ex
    sock.close
    raise ex
  end
end

#close ⇒ Object

See IO#close for details.



200
201
202
 
# File 'lib/jopenssl21/openssl/ssl.rb', line 200

def close
  @svr.close
end

#listen(backlog = 5) ⇒ Object

See TCPServer#listen for details.



176
177
178
 
# File 'lib/jopenssl21/openssl/ssl.rb', line 176

def listen(backlog=5)
  @svr.listen(backlog)
end

#shutdown(how = Socket::SHUT_RDWR) ⇒ Object

See BasicSocket#shutdown for details.



181
182
183
 
# File 'lib/jopenssl21/openssl/ssl.rb', line 181

def shutdown(how=Socket::SHUT_RDWR)
  @svr.shutdown(how)
end

#to_io ⇒ Object

Returns the TCPServer passed to the SSLServer when initialized.



171
172
173
 
# File 'lib/jopenssl21/openssl/ssl.rb', line 171

def to_io
  @svr
end