k-yamada-net-ssh 2.3.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (122) hide show
  1. data/CHANGELOG.rdoc +262 -0
  2. data/Manifest +121 -0
  3. data/README.rdoc +184 -0
  4. data/Rakefile +86 -0
  5. data/Rudyfile +96 -0
  6. data/THANKS.rdoc +19 -0
  7. data/lib/net/ssh.rb +223 -0
  8. data/lib/net/ssh/authentication/agent.rb +179 -0
  9. data/lib/net/ssh/authentication/constants.rb +18 -0
  10. data/lib/net/ssh/authentication/key_manager.rb +253 -0
  11. data/lib/net/ssh/authentication/methods/abstract.rb +60 -0
  12. data/lib/net/ssh/authentication/methods/hostbased.rb +75 -0
  13. data/lib/net/ssh/authentication/methods/keyboard_interactive.rb +70 -0
  14. data/lib/net/ssh/authentication/methods/password.rb +43 -0
  15. data/lib/net/ssh/authentication/methods/publickey.rb +96 -0
  16. data/lib/net/ssh/authentication/pageant.rb +264 -0
  17. data/lib/net/ssh/authentication/session.rb +146 -0
  18. data/lib/net/ssh/buffer.rb +340 -0
  19. data/lib/net/ssh/buffered_io.rb +198 -0
  20. data/lib/net/ssh/config.rb +207 -0
  21. data/lib/net/ssh/connection/channel.rb +630 -0
  22. data/lib/net/ssh/connection/constants.rb +33 -0
  23. data/lib/net/ssh/connection/session.rb +597 -0
  24. data/lib/net/ssh/connection/term.rb +178 -0
  25. data/lib/net/ssh/errors.rb +88 -0
  26. data/lib/net/ssh/key_factory.rb +102 -0
  27. data/lib/net/ssh/known_hosts.rb +129 -0
  28. data/lib/net/ssh/loggable.rb +61 -0
  29. data/lib/net/ssh/packet.rb +102 -0
  30. data/lib/net/ssh/prompt.rb +93 -0
  31. data/lib/net/ssh/proxy/command.rb +75 -0
  32. data/lib/net/ssh/proxy/errors.rb +14 -0
  33. data/lib/net/ssh/proxy/http.rb +94 -0
  34. data/lib/net/ssh/proxy/socks4.rb +70 -0
  35. data/lib/net/ssh/proxy/socks5.rb +142 -0
  36. data/lib/net/ssh/ruby_compat.rb +43 -0
  37. data/lib/net/ssh/service/forward.rb +298 -0
  38. data/lib/net/ssh/test.rb +89 -0
  39. data/lib/net/ssh/test/channel.rb +129 -0
  40. data/lib/net/ssh/test/extensions.rb +152 -0
  41. data/lib/net/ssh/test/kex.rb +44 -0
  42. data/lib/net/ssh/test/local_packet.rb +51 -0
  43. data/lib/net/ssh/test/packet.rb +81 -0
  44. data/lib/net/ssh/test/remote_packet.rb +38 -0
  45. data/lib/net/ssh/test/script.rb +157 -0
  46. data/lib/net/ssh/test/socket.rb +64 -0
  47. data/lib/net/ssh/transport/algorithms.rb +386 -0
  48. data/lib/net/ssh/transport/cipher_factory.rb +79 -0
  49. data/lib/net/ssh/transport/constants.rb +30 -0
  50. data/lib/net/ssh/transport/hmac.rb +42 -0
  51. data/lib/net/ssh/transport/hmac/abstract.rb +79 -0
  52. data/lib/net/ssh/transport/hmac/md5.rb +12 -0
  53. data/lib/net/ssh/transport/hmac/md5_96.rb +11 -0
  54. data/lib/net/ssh/transport/hmac/none.rb +15 -0
  55. data/lib/net/ssh/transport/hmac/sha1.rb +13 -0
  56. data/lib/net/ssh/transport/hmac/sha1_96.rb +11 -0
  57. data/lib/net/ssh/transport/hmac/sha2_256.rb +15 -0
  58. data/lib/net/ssh/transport/hmac/sha2_256_96.rb +13 -0
  59. data/lib/net/ssh/transport/hmac/sha2_512.rb +14 -0
  60. data/lib/net/ssh/transport/hmac/sha2_512_96.rb +13 -0
  61. data/lib/net/ssh/transport/identity_cipher.rb +55 -0
  62. data/lib/net/ssh/transport/kex.rb +17 -0
  63. data/lib/net/ssh/transport/kex/diffie_hellman_group1_sha1.rb +208 -0
  64. data/lib/net/ssh/transport/kex/diffie_hellman_group_exchange_sha1.rb +80 -0
  65. data/lib/net/ssh/transport/kex/diffie_hellman_group_exchange_sha256.rb +15 -0
  66. data/lib/net/ssh/transport/key_expander.rb +26 -0
  67. data/lib/net/ssh/transport/openssl.rb +127 -0
  68. data/lib/net/ssh/transport/packet_stream.rb +235 -0
  69. data/lib/net/ssh/transport/server_version.rb +71 -0
  70. data/lib/net/ssh/transport/session.rb +278 -0
  71. data/lib/net/ssh/transport/state.rb +206 -0
  72. data/lib/net/ssh/verifiers/lenient.rb +30 -0
  73. data/lib/net/ssh/verifiers/null.rb +12 -0
  74. data/lib/net/ssh/verifiers/strict.rb +53 -0
  75. data/lib/net/ssh/version.rb +62 -0
  76. data/net-ssh.gemspec +144 -0
  77. data/setup.rb +1585 -0
  78. data/support/arcfour_check.rb +20 -0
  79. data/support/ssh_tunnel_bug.rb +65 -0
  80. data/test/authentication/methods/common.rb +28 -0
  81. data/test/authentication/methods/test_abstract.rb +51 -0
  82. data/test/authentication/methods/test_hostbased.rb +114 -0
  83. data/test/authentication/methods/test_keyboard_interactive.rb +100 -0
  84. data/test/authentication/methods/test_password.rb +52 -0
  85. data/test/authentication/methods/test_publickey.rb +148 -0
  86. data/test/authentication/test_agent.rb +205 -0
  87. data/test/authentication/test_key_manager.rb +171 -0
  88. data/test/authentication/test_session.rb +106 -0
  89. data/test/common.rb +107 -0
  90. data/test/configs/eqsign +3 -0
  91. data/test/configs/exact_match +8 -0
  92. data/test/configs/host_plus +10 -0
  93. data/test/configs/multihost +4 -0
  94. data/test/configs/wild_cards +14 -0
  95. data/test/connection/test_channel.rb +467 -0
  96. data/test/connection/test_session.rb +488 -0
  97. data/test/test_all.rb +9 -0
  98. data/test/test_buffer.rb +336 -0
  99. data/test/test_buffered_io.rb +63 -0
  100. data/test/test_config.rb +120 -0
  101. data/test/test_key_factory.rb +79 -0
  102. data/test/transport/hmac/test_md5.rb +39 -0
  103. data/test/transport/hmac/test_md5_96.rb +25 -0
  104. data/test/transport/hmac/test_none.rb +34 -0
  105. data/test/transport/hmac/test_sha1.rb +34 -0
  106. data/test/transport/hmac/test_sha1_96.rb +25 -0
  107. data/test/transport/hmac/test_sha2_256.rb +35 -0
  108. data/test/transport/hmac/test_sha2_256_96.rb +25 -0
  109. data/test/transport/hmac/test_sha2_512.rb +35 -0
  110. data/test/transport/hmac/test_sha2_512_96.rb +25 -0
  111. data/test/transport/kex/test_diffie_hellman_group1_sha1.rb +146 -0
  112. data/test/transport/kex/test_diffie_hellman_group_exchange_sha1.rb +92 -0
  113. data/test/transport/kex/test_diffie_hellman_group_exchange_sha256.rb +33 -0
  114. data/test/transport/test_algorithms.rb +308 -0
  115. data/test/transport/test_cipher_factory.rb +213 -0
  116. data/test/transport/test_hmac.rb +34 -0
  117. data/test/transport/test_identity_cipher.rb +40 -0
  118. data/test/transport/test_packet_stream.rb +736 -0
  119. data/test/transport/test_server_version.rb +78 -0
  120. data/test/transport/test_session.rb +315 -0
  121. data/test/transport/test_state.rb +179 -0
  122. metadata +176 -0
@@ -0,0 +1,80 @@
1
+ require 'net/ssh/errors'
2
+ require 'net/ssh/transport/constants'
3
+ require 'net/ssh/transport/kex/diffie_hellman_group1_sha1'
4
+
5
+ module Net::SSH::Transport::Kex
6
+
7
+ # A key-exchange service implementing the
8
+ # "diffie-hellman-group-exchange-sha1" key-exchange algorithm.
9
+ class DiffieHellmanGroupExchangeSHA1 < DiffieHellmanGroup1SHA1
10
+ MINIMUM_BITS = 1024
11
+ MAXIMUM_BITS = 8192
12
+
13
+ KEXDH_GEX_GROUP = 31
14
+ KEXDH_GEX_INIT = 32
15
+ KEXDH_GEX_REPLY = 33
16
+ KEXDH_GEX_REQUEST = 34
17
+
18
+ private
19
+
20
+ # Compute the number of bits needed for the given number of bytes.
21
+ def compute_need_bits
22
+
23
+ # for Compatibility: OpenSSH requires (need_bits * 2 + 1) length of parameter
24
+ need_bits = data[:need_bytes] * 8 * 2 + 1
25
+
26
+ if need_bits < MINIMUM_BITS
27
+ need_bits = MINIMUM_BITS
28
+ elsif need_bits > MAXIMUM_BITS
29
+ need_bits = MAXIMUM_BITS
30
+ end
31
+
32
+ data[:need_bits ] = need_bits
33
+ data[:need_bytes] = need_bits / 8
34
+ end
35
+
36
+ # Returns the DH key parameters for the given session.
37
+ def get_parameters
38
+ compute_need_bits
39
+
40
+ # request the DH key parameters for the given number of bits.
41
+ buffer = Net::SSH::Buffer.from(:byte, KEXDH_GEX_REQUEST, :long, MINIMUM_BITS,
42
+ :long, data[:need_bits], :long, MAXIMUM_BITS)
43
+ connection.send_message(buffer)
44
+
45
+ buffer = connection.next_message
46
+ unless buffer.type == KEXDH_GEX_GROUP
47
+ raise Net::SSH::Exception, "expected KEXDH_GEX_GROUP, got #{buffer.type}"
48
+ end
49
+
50
+ p = buffer.read_bignum
51
+ g = buffer.read_bignum
52
+
53
+ [p, g]
54
+ end
55
+
56
+ # Returns the INIT/REPLY constants used by this algorithm.
57
+ def get_message_types
58
+ [KEXDH_GEX_INIT, KEXDH_GEX_REPLY]
59
+ end
60
+
61
+ # Build the signature buffer to use when verifying a signature from
62
+ # the server.
63
+ def build_signature_buffer(result)
64
+ response = Net::SSH::Buffer.new
65
+ response.write_string data[:client_version_string],
66
+ data[:server_version_string],
67
+ data[:client_algorithm_packet],
68
+ data[:server_algorithm_packet],
69
+ result[:key_blob]
70
+ response.write_long MINIMUM_BITS,
71
+ data[:need_bits],
72
+ MAXIMUM_BITS
73
+ response.write_bignum dh.p, dh.g, dh.pub_key,
74
+ result[:server_dh_pubkey],
75
+ result[:shared_secret]
76
+ response
77
+ end
78
+ end
79
+
80
+ end
@@ -0,0 +1,15 @@
1
+ require 'net/ssh/transport/kex/diffie_hellman_group_exchange_sha1'
2
+
3
+ module Net::SSH::Transport::Kex
4
+ if defined?(OpenSSL::Digest::SHA256)
5
+ # A key-exchange service implementing the
6
+ # "diffie-hellman-group-exchange-sha256" key-exchange algorithm.
7
+ class DiffieHellmanGroupExchangeSHA256 < DiffieHellmanGroupExchangeSHA1
8
+ def initialize(*args)
9
+ super(*args)
10
+
11
+ @digester = OpenSSL::Digest::SHA256
12
+ end
13
+ end
14
+ end
15
+ end
@@ -0,0 +1,26 @@
1
+ module Net; module SSH; module Transport
2
+ module KeyExpander
3
+
4
+ # Generate a key value in accordance with the SSH2 specification.
5
+ # (RFC4253 7.2. "Output from Key Exchange")
6
+ def self.expand_key(bytes, start, options={})
7
+ if bytes == 0
8
+ return ""
9
+ end
10
+
11
+ k = start[0, bytes]
12
+
13
+ digester = options[:digester] or raise 'No digester supplied'
14
+ shared = options[:shared] or raise 'No shared secret supplied'
15
+ hash = options[:hash] or raise 'No hash supplied'
16
+
17
+ while k.length < bytes
18
+ step = digester.digest(shared + hash + k)
19
+ bytes_needed = bytes - k.length
20
+ k << step[0, bytes_needed]
21
+ end
22
+
23
+ return k
24
+ end
25
+ end
26
+ end; end; end
@@ -0,0 +1,127 @@
1
+ require 'openssl'
2
+
3
+ module OpenSSL
4
+
5
+ # This class is originally defined in the OpenSSL module. As needed, methods
6
+ # have been added to it by the Net::SSH module for convenience in dealing with
7
+ # SSH functionality.
8
+ class BN
9
+
10
+ # Converts a BN object to a string. The format used is that which is
11
+ # required by the SSH2 protocol.
12
+ def to_ssh
13
+ if zero?
14
+ return [0].pack("N")
15
+ else
16
+ buf = to_s(2)
17
+ if buf.getbyte(0)[7] == 1
18
+ return [buf.length+1, 0, buf].pack("NCA*")
19
+ else
20
+ return [buf.length, buf].pack("NA*")
21
+ end
22
+ end
23
+ end
24
+
25
+ end
26
+
27
+ module PKey
28
+
29
+ class PKey
30
+ def fingerprint
31
+ @fingerprint ||= OpenSSL::Digest::MD5.hexdigest(to_blob).scan(/../).join(":")
32
+ end
33
+ end
34
+
35
+ # This class is originally defined in the OpenSSL module. As needed, methods
36
+ # have been added to it by the Net::SSH module for convenience in dealing
37
+ # with SSH functionality.
38
+ class DH
39
+
40
+ # Determines whether the pub_key for this key is valid. (This algorithm
41
+ # lifted more-or-less directly from OpenSSH, dh.c, dh_pub_is_valid.)
42
+ def valid?
43
+ return false if pub_key.nil? || pub_key < 0
44
+ bits_set = 0
45
+ pub_key.num_bits.times { |i| bits_set += 1 if pub_key.bit_set?(i) }
46
+ return ( bits_set > 1 && pub_key < p )
47
+ end
48
+
49
+ end
50
+
51
+ # This class is originally defined in the OpenSSL module. As needed, methods
52
+ # have been added to it by the Net::SSH module for convenience in dealing
53
+ # with SSH functionality.
54
+ class RSA
55
+
56
+ # Returns "ssh-rsa", which is the description of this key type used by the
57
+ # SSH2 protocol.
58
+ def ssh_type
59
+ "ssh-rsa"
60
+ end
61
+
62
+ # Converts the key to a blob, according to the SSH2 protocol.
63
+ def to_blob
64
+ @blob ||= Net::SSH::Buffer.from(:string, ssh_type, :bignum, e, :bignum, n).to_s
65
+ end
66
+
67
+ # Verifies the given signature matches the given data.
68
+ def ssh_do_verify(sig, data)
69
+ verify(OpenSSL::Digest::SHA1.new, sig, data)
70
+ end
71
+
72
+ # Returns the signature for the given data.
73
+ def ssh_do_sign(data)
74
+ sign(OpenSSL::Digest::SHA1.new, data)
75
+ end
76
+ end
77
+
78
+ # This class is originally defined in the OpenSSL module. As needed, methods
79
+ # have been added to it by the Net::SSH module for convenience in dealing
80
+ # with SSH functionality.
81
+ class DSA
82
+
83
+ # Returns "ssh-dss", which is the description of this key type used by the
84
+ # SSH2 protocol.
85
+ def ssh_type
86
+ "ssh-dss"
87
+ end
88
+
89
+ # Converts the key to a blob, according to the SSH2 protocol.
90
+ def to_blob
91
+ @blob ||= Net::SSH::Buffer.from(:string, ssh_type,
92
+ :bignum, p, :bignum, q, :bignum, g, :bignum, pub_key).to_s
93
+ end
94
+
95
+ # Verifies the given signature matches the given data.
96
+ def ssh_do_verify(sig, data)
97
+ sig_r = sig[0,20].unpack("H*")[0].to_i(16)
98
+ sig_s = sig[20,20].unpack("H*")[0].to_i(16)
99
+ a1sig = OpenSSL::ASN1::Sequence([
100
+ OpenSSL::ASN1::Integer(sig_r),
101
+ OpenSSL::ASN1::Integer(sig_s)
102
+ ])
103
+ return verify(OpenSSL::Digest::DSS1.new, a1sig.to_der, data)
104
+ end
105
+
106
+ # Signs the given data.
107
+ def ssh_do_sign(data)
108
+ sig = sign( OpenSSL::Digest::DSS1.new, data)
109
+ a1sig = OpenSSL::ASN1.decode( sig )
110
+
111
+ sig_r = a1sig.value[0].value.to_s(2)
112
+ sig_s = a1sig.value[1].value.to_s(2)
113
+
114
+ if sig_r.length > 20 || sig_s.length > 20
115
+ raise OpenSSL::PKey::DSAError, "bad sig size"
116
+ end
117
+
118
+ sig_r = "\0" * ( 20 - sig_r.length ) + sig_r if sig_r.length < 20
119
+ sig_s = "\0" * ( 20 - sig_s.length ) + sig_s if sig_s.length < 20
120
+
121
+ return sig_r + sig_s
122
+ end
123
+ end
124
+
125
+ end
126
+
127
+ end
@@ -0,0 +1,235 @@
1
+ require 'net/ssh/buffered_io'
2
+ require 'net/ssh/errors'
3
+ require 'net/ssh/packet'
4
+ require 'net/ssh/ruby_compat'
5
+ require 'net/ssh/transport/cipher_factory'
6
+ require 'net/ssh/transport/hmac'
7
+ require 'net/ssh/transport/state'
8
+
9
+
10
+ module Net; module SSH; module Transport
11
+
12
+ # A module that builds additional functionality onto the Net::SSH::BufferedIo
13
+ # module. It adds SSH encryption, compression, and packet validation, as
14
+ # per the SSH2 protocol. It also adds an abstraction for polling packets,
15
+ # to allow for both blocking and non-blocking reads.
16
+ module PacketStream
17
+ include BufferedIo
18
+
19
+ def self.extended(object)
20
+ object.__send__(:initialize_ssh)
21
+ end
22
+
23
+ # The map of "hints" that can be used to modify the behavior of the packet
24
+ # stream. For instance, when authentication succeeds, an "authenticated"
25
+ # hint is set, which is used to determine whether or not to compress the
26
+ # data when using the "delayed" compression algorithm.
27
+ attr_reader :hints
28
+
29
+ # The server state object, which encapsulates the algorithms used to interpret
30
+ # packets coming from the server.
31
+ attr_reader :server
32
+
33
+ # The client state object, which encapsulates the algorithms used to build
34
+ # packets to send to the server.
35
+ attr_reader :client
36
+
37
+ # The name of the client (local) end of the socket, as reported by the
38
+ # socket.
39
+ def client_name
40
+ @client_name ||= begin
41
+ sockaddr = getsockname
42
+ begin
43
+ Socket.getnameinfo(sockaddr, Socket::NI_NAMEREQD).first
44
+ rescue
45
+ begin
46
+ Socket.getnameinfo(sockaddr).first
47
+ rescue
48
+ begin
49
+ Socket.gethostbyname(Socket.gethostname).first
50
+ rescue
51
+ lwarn { "the client ipaddr/name could not be determined" }
52
+ "unknown"
53
+ end
54
+ end
55
+ end
56
+ end
57
+ end
58
+
59
+ # The IP address of the peer (remote) end of the socket, as reported by
60
+ # the socket.
61
+ def peer_ip
62
+ @peer_ip ||=
63
+ if respond_to?(:getpeername)
64
+ addr = getpeername
65
+ Socket.getnameinfo(addr, Socket::NI_NUMERICHOST | Socket::NI_NUMERICSERV).first
66
+ else
67
+ "<no hostip for proxy command>"
68
+ end
69
+ end
70
+
71
+ # Returns true if the IO is available for reading, and false otherwise.
72
+ def available_for_read?
73
+ result = Net::SSH::Compat.io_select([self], nil, nil, 0)
74
+ result && result.first.any?
75
+ end
76
+
77
+ # Returns the next full packet. If the mode parameter is :nonblock (the
78
+ # default), then this will return immediately, whether a packet is
79
+ # available or not, and will return nil if there is no packet ready to be
80
+ # returned. If the mode parameter is :block, then this method will block
81
+ # until a packet is available.
82
+ def next_packet(mode=:nonblock)
83
+ case mode
84
+ when :nonblock then
85
+ fill if available_for_read?
86
+ poll_next_packet
87
+
88
+ when :block then
89
+ loop do
90
+ packet = poll_next_packet
91
+ return packet if packet
92
+
93
+ loop do
94
+ result = Net::SSH::Compat.io_select([self]) or next
95
+ break if result.first.any?
96
+ end
97
+
98
+ if fill <= 0
99
+ raise Net::SSH::Disconnect, "connection closed by remote host"
100
+ end
101
+ end
102
+
103
+ else
104
+ raise ArgumentError, "expected :block or :nonblock, got #{mode.inspect}"
105
+ end
106
+ end
107
+
108
+ # Enqueues a packet to be sent, and blocks until the entire packet is
109
+ # sent.
110
+ def send_packet(payload)
111
+ enqueue_packet(payload)
112
+ wait_for_pending_sends
113
+ end
114
+
115
+ # Enqueues a packet to be sent, but does not immediately send the packet.
116
+ # The given payload is pre-processed according to the algorithms specified
117
+ # in the client state (compression, cipher, and hmac).
118
+ def enqueue_packet(payload)
119
+ # try to compress the packet
120
+ payload = client.compress(payload)
121
+
122
+ # the length of the packet, minus the padding
123
+ actual_length = 4 + payload.length + 1
124
+
125
+ # compute the padding length
126
+ padding_length = client.block_size - (actual_length % client.block_size)
127
+ padding_length += client.block_size if padding_length < 4
128
+
129
+ # compute the packet length (sans the length field itself)
130
+ packet_length = payload.length + padding_length + 1
131
+
132
+ if packet_length < 16
133
+ padding_length += client.block_size
134
+ packet_length = payload.length + padding_length + 1
135
+ end
136
+
137
+ padding = Array.new(padding_length) { rand(256) }.pack("C*")
138
+
139
+ unencrypted_data = [packet_length, padding_length, payload, padding].pack("NCA*A*")
140
+ mac = client.hmac.digest([client.sequence_number, unencrypted_data].pack("NA*"))
141
+
142
+ encrypted_data = client.update_cipher(unencrypted_data) << client.final_cipher
143
+ message = encrypted_data + mac
144
+
145
+ debug { "queueing packet nr #{client.sequence_number} type #{payload.getbyte(0)} len #{packet_length}" }
146
+ enqueue(message)
147
+
148
+ client.increment(packet_length)
149
+
150
+ self
151
+ end
152
+
153
+ # Performs any pending cleanup necessary on the IO and its associated
154
+ # state objects. (See State#cleanup).
155
+ def cleanup
156
+ client.cleanup
157
+ server.cleanup
158
+ end
159
+
160
+ # If the IO object requires a rekey operation (as indicated by either its
161
+ # client or server state objects, see State#needs_rekey?), this will
162
+ # yield. Otherwise, this does nothing.
163
+ def if_needs_rekey?
164
+ if client.needs_rekey? || server.needs_rekey?
165
+ yield
166
+ client.reset! if client.needs_rekey?
167
+ server.reset! if server.needs_rekey?
168
+ end
169
+ end
170
+
171
+ protected
172
+
173
+ # Called when this module is used to extend an object. It initializes
174
+ # the states and generally prepares the object for use as a packet stream.
175
+ def initialize_ssh
176
+ @hints = {}
177
+ @server = State.new(self, :server)
178
+ @client = State.new(self, :client)
179
+ @packet = nil
180
+ initialize_buffered_io
181
+ end
182
+
183
+ # Tries to read the next packet. If there is insufficient data to read
184
+ # an entire packet, this returns immediately, otherwise the packet is
185
+ # read, post-processed according to the cipher, hmac, and compression
186
+ # algorithms specified in the server state object, and returned as a
187
+ # new Packet object.
188
+ def poll_next_packet
189
+ if @packet.nil?
190
+ minimum = server.block_size < 4 ? 4 : server.block_size
191
+ return nil if available < minimum
192
+ data = read_available(minimum)
193
+
194
+ # decipher it
195
+ @packet = Net::SSH::Buffer.new(server.update_cipher(data))
196
+ @packet_length = @packet.read_long
197
+ end
198
+
199
+ need = @packet_length + 4 - server.block_size
200
+ raise Net::SSH::Exception, "padding error, need #{need} block #{server.block_size}" if need % server.block_size != 0
201
+
202
+ return nil if available < need + server.hmac.mac_length
203
+
204
+ if need > 0
205
+ # read the remainder of the packet and decrypt it.
206
+ data = read_available(need)
207
+ @packet.append(server.update_cipher(data))
208
+ end
209
+
210
+ # get the hmac from the tail of the packet (if one exists), and
211
+ # then validate it.
212
+ real_hmac = read_available(server.hmac.mac_length) || ""
213
+
214
+ @packet.append(server.final_cipher)
215
+ padding_length = @packet.read_byte
216
+
217
+ payload = @packet.read(@packet_length - padding_length - 1)
218
+ padding = @packet.read(padding_length) if padding_length > 0
219
+
220
+ my_computed_hmac = server.hmac.digest([server.sequence_number, @packet.content].pack("NA*"))
221
+ raise Net::SSH::Exception, "corrupted mac detected" if real_hmac != my_computed_hmac
222
+
223
+ # try to decompress the payload, in case compression is active
224
+ payload = server.decompress(payload)
225
+
226
+ debug { "received packet nr #{server.sequence_number} type #{payload.getbyte(0)} len #{@packet_length}" }
227
+
228
+ server.increment(@packet_length)
229
+ @packet = nil
230
+
231
+ return Packet.new(payload)
232
+ end
233
+ end
234
+
235
+ end; end; end