Class: TTTLS13::Message::Extensions

Inherits:
Hash
  • Object
show all
Defined in:
lib/tttls1.3/message/extensions.rb

Overview

rubocop: disable Metrics/ClassLength

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(extensions = []) ⇒ Extensions

Returns a new instance of Extensions.

Examples:

Extensions.new([SupportedVersions.new, ServerName.new('example.com')]

Parameters:



16
17
18
19
20
 
# File 'lib/tttls1.3/message/extensions.rb', line 16

def initialize(extensions = [])
  extensions.each do |ex|
    super[ex.extension_type] = ex
  end
end

Class Method Details

.deserialize(binary, msg_type) ⇒ TTTLS13::Message::Extensions

Parameters:

Returns:

Raises:



46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
 
# File 'lib/tttls1.3/message/extensions.rb', line 46

def self.deserialize(binary, msg_type)
  raise Error::ErrorAlerts, :internal_error if binary.nil?

  exs = Extensions.new
  i = 0
  while i < binary.length
    raise Error::ErrorAlerts, :decode_error if i + 4 > binary.length

    extension_type = binary.slice(i, 2)
    i += 2
    ex_len = Convert.bin2i(binary.slice(i, 2))
    i += 2

    raise Error::ErrorAlerts, :decode_error if i + ex_len > binary.length

    ex_bin = binary.slice(i, ex_len)
    ex = deserialize_extension(ex_bin, extension_type, msg_type)
    if ex.nil?
      # ignore unparsable binary, but only transcript
      ex = Extension::UnknownExtension.new(extension_type:,
                                           extension_data: ex_bin)
    end

    # There MUST NOT be more than one extension of the same type in a
    # given extension block.
    raise Error::ErrorAlerts, :unsupported_extension \
      if exs.include?(extension_type)

    exs[extension_type] = ex
    i += ex_len
  end
  raise Error::ErrorAlerts, :decode_error unless i == binary.length

  exs
end

Instance Method Details

#<<(ex) ⇒ TTTLS13::Message::Extension::$Object

Parameters:

Returns:



99
100
101
 
# File 'lib/tttls1.3/message/extensions.rb', line 99

def <<(ex)
  store(ex.extension_type, ex)
end

#[](key) ⇒ Object 



92
93
94
 
# File 'lib/tttls1.3/message/extensions.rb', line 92

def [](key)
  fetch(key)
end

#fetch(key, default = nil) ⇒ TTTLS13::Message::Extension::$Object

Parameters:

Returns:



86
87
88
89
90
 
# File 'lib/tttls1.3/message/extensions.rb', line 86

def fetch(key, default = nil)
  return nil if super_fetch(key, nil).is_a?(Extension::UnknownExtension)

  super_fetch(key, default)
end

#remove_and_replace!(outer_extensions) ⇒ TTTLS13::Message::Extensions

removing and replacing extensions from EncodedClientHelloInner with a single “ech_outer_extensions”

for example

  • before

    • self.keys: [A B C D E]

    • param : [D B]

  • after remove_and_replace!

    • self.keys: [A C E B D]

    • return : [A C E ech_outer_extensions[B D]]

Parameters:

Returns:



116
117
118
119
120
121
122
123
124
125
126
127
128
129
 
# File 'lib/tttls1.3/message/extensions.rb', line 116

def remove_and_replace!(outer_extensions)
  tmp1 = filter { |k, _| !outer_extensions.include?(k) }
  tmp2 = filter { |k, _| outer_extensions.include?(k) }

  clear
  replaced = Message::Extensions.new

  tmp1.each_value { |v| self << v; replaced << v }
  tmp2.each_value { |v| self << v }
  replaced << Message::Extension::ECHOuterExtensions.new(tmp2.keys) \
    unless tmp2.keys.empty?

  replaced
end

#serialize ⇒ String

“pre_shared_key” MUST be the last extension in the ClientHello

Returns:

  • (String) 


27
28
29
30
31
32
33
34
35
36
37
38
 
# File 'lib/tttls1.3/message/extensions.rb', line 27

def serialize
  except_ch_psk = values.reject do |ex|
    ex.extension_type == ExtensionType::PRE_SHARED_KEY &&
      ex.msg_type == HandshakeType::CLIENT_HELLO
  end
  binary = except_ch_psk.map(&:serialize).join

  psk = super_fetch(ExtensionType::PRE_SHARED_KEY, nil)
  binary += psk.serialize if psk&.msg_type == HandshakeType::CLIENT_HELLO

  binary.prefix_uint16_length
end

#super_fetch ⇒ Object 



22
 
# File 'lib/tttls1.3/message/extensions.rb', line 22

alias super_fetch fetch