Module: Sockudo::Utils

Included in:
Channel, Client
Defined in:
lib/sockudo/utils.rb

Instance Method Summary collapse

Instance Method Details

#_authentication_string(socket_id, string_to_sign, token, custom_string = nil) ⇒ String

Compute authentication string required as part of the user authentication and subscription authorization endpoints responses. Generally the authenticate method should be used in preference to this one.

Parameters:

  • socket_id (String) —

    Each Sockudo socket connection receives a unique socket_id. This is sent from sockudo.js to your server when channel authentication is required.

  • custom_string (String) (defaults to: nil) —

    Allows signing additional data

Returns:

  • (String)

Raises:



23
24
25
26
27
28
29
30
31
32
33
34
 
# File 'lib/sockudo/utils.rb', line 23

def _authentication_string(socket_id, string_to_sign, token, custom_string = nil)
  validate_socket_id(socket_id)

  raise Sockudo::Error, 'Custom argument must be a string' unless custom_string.nil? || custom_string.is_a?(String)

  Sockudo.logger.debug "Signing #{string_to_sign}"

  digest = OpenSSL::Digest.new('SHA256')
  signature = OpenSSL::HMAC.hexdigest(digest, token.secret, string_to_sign)

  "#{token.key}:#{signature}"
end

#validate_socket_id(socket_id) ⇒ Object

Raises:



5
6
7
8
9
 
# File 'lib/sockudo/utils.rb', line 5

def validate_socket_id(socket_id)
  return if socket_id && /\A\d+\.\d+\z/.match(socket_id)

  raise Sockudo::Error, "Invalid socket ID #{socket_id.inspect}"
end