123456789_123456789_123456789_123456789_123456789_

Module: Mongo::Address::Validator Private

Do not use. This module is for internal use only.
Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Included In:
::Mongo::Srv::Result, ::Mongo::URI, ::Mongo::URI::SRVProtocol
Defined in: lib/mongo/address/validator.rb

Overview

Since:

  • 2.0.0

Instance Method Summary

Instance Method Details

#validate_address_str!(address_str)

Takes an address string in ipv4/ipv6/hostname/socket path format and validates its format.

Since:

  • 2.0.0

[ GitHub ] 

  


# File 'lib/mongo/address/validator.rb', line 27



def validate_address_str!(address_str)
  case address_str
  when /\A\[[\d:]+\](?::(\d+))?\z/
    # ipv6 with optional port
    if port_str = $1
      validate_port_str!(port_str)
    end
  when /\A\//, /\.sock\z/
    # Unix socket path.
    # Spec requires us to validate that the path has no unescaped
    # slashes, but if this were to be the case, parsing would have
    # already failed elsewhere because the URI would've been split in
    # a weird place.
    # The spec also allows relative socket paths and requires that
    # socket paths end in ".sock". We accept all paths but special case
    # the .sock extension to avoid relative paths falling into the
    # host:port case below.
  when /[\/\[\]]/
    # Not a host:port nor an ipv4 address with optional port.
    # Possibly botched ipv6 address with e.g. port delimiter present and
    # port missing, or extra junk before or after.
    raise Error::InvalidAddress,
      "Invalid hostname: #{address_str}"
  when /:.*:/m
    raise Error::InvalidAddress,
      "Multiple port delimiters are not allowed: #{address_str}"
  else
    # host:port or ipv4 address with optional port number
    host, port = address_str.split(':')
    if host.empty?
      raise Error::InvalidAddress, "Host is empty: #{address_str}"
    end

    validate_hostname!(host)

    if port && port.empty?
      raise Error::InvalidAddress, "Port is empty: #{address_str}"
    end

    validate_port_str!(port)
  end
end


  








  

    #validate_hostname!(host)   (private)
  



  

    

Validates format of the hostname, in particular for further use as the origin in same origin verification.



The hostname must have been normalized to remove the trailing dot if it was obtained from a DNS record. This method prohibits trailing dots.


  





  
Since:


    
  
  • 
    
    

    2.0.0
    

    
  
    • 





  [ GitHub ]


  

  


# File 'lib/mongo/address/validator.rb', line 77



def validate_hostname!(host)
  # Since we are performing same origin verification during SRV
  # processing, prohibit leading dots in hostnames, trailing dots
  # and runs of multiple dots. DNS resolution of SRV records yields
  # hostnames with trailing dots, those trailing dots are removed
  # during normalization process prior to validation.
  if host.start_with?('.')
    raise Error::InvalidAddress, "Hostname cannot start with a dot: #{host}"
  end
  if host.end_with?('.')
    raise Error::InvalidAddress, "Hostname cannot end with a dot: #{host}"
  end
  if host.include?('..')
    raise Error::InvalidAddress, "Runs of multiple dots are not allowed in hostname: #{host}"
  end
end


  








  

    #validate_port_str!(port)   (private)
  



  

    
  





  
Since:


    
  
  • 
    
    

    2.0.0
    

    
  
    • 





  [ GitHub ]


  

  


# File 'lib/mongo/address/validator.rb', line 94



def validate_port_str!(port)
  unless port.nil? || (port.length > 0 && port.to_i > 0 && port.to_i <= 65535)
    raise Error::InvalidAddress,
      "Invalid port: #{port}. Port must be an integer greater than 0 and less than 65536"
  end
end