shodan

Documentation

Index

• func GetErrorFromResponse(r *http.Response) error
• func ListenAlerts() error
• type Facet
• type Host
• type HostCertificate
• type HostCertificateAttributes
• type HostCertificateExtension
• type HostCertificatePublicKey
• type HostCipher
• type HostDHParams
• type HostData
• type HostLocation
• type HostMatch
• type HostQueryOptions
• type HostQueryTokens
• type HostSSL
• type HostServicesOptions
• type HostTLSExtEntry
• type IntString
  • func (v *IntString) String() string
  • func (v *IntString) UnmarshalJSON(b []byte) error

Functions

func GetErrorFromResponse

func GetErrorFromResponse(r *http.Response) error

GetErrorFromResponse used to getting errors from streaming api endpoint

func ListenAlerts

func ListenAlerts() error

ListenAlerts : Used to listen streaming monitoring API

Types

type Facet

type Facet struct {
	Count int    `json:"count"`
	Value string `json:"value"`
}

Facet is a property to get summary information on.

type Host

type Host struct {
	OS              string      `json:"os"`
	Ports           []int       `json:"ports"`
	IP              net.IP      `json:"ip_str"`
	ISP             string      `json:"isp"`
	Hostnames       []string    `json:"hostnames"`
	Organization    string      `json:"org"`
	Vulnerabilities []string    `json:"vulns"`
	ASN             string      `json:"asn"`
	LastUpdate      string      `json:"last_update"`
	Data            []*HostData `json:"data"`
	HostLocation
}

Host is the all information about the host.

type HostCertificate

type HostCertificate struct {
	SignatureAlgorithm string                      `json:"sig_alg"`
	IsExpired          bool                        `json:"expired"`
	Version            int                         `json:"version"`
	Serial             *big.Int                    `json:"serial"`
	Issued             string                      `json:"issued"`
	Expires            string                      `json:"expires"`
	Fingerprint        map[string]string           `json:"fingerprint"`
	Issuer             *HostCertificateAttributes  `json:"issuer"`
	Subject            *HostCertificateAttributes  `json:"subject"`
	PublicKey          *HostCertificatePublicKey   `json:"pubkey"`
	Extensions         []*HostCertificateExtension `json:"extensions"`
}

HostCertificate contains common certificate description.

type HostCertificateAttributes

type HostCertificateAttributes struct {
	CountryName         string `json:"C,omitempty"`
	CommonName          string `json:"CN,omitempty"`
	Locality            string `json:"L,omitempty"`
	Organization        string `json:"O,omitempty"`
	StateOrProvinceName string `json:"ST,omitempty"`
	OrganizationalUnit  string `json:"OU,omitempty"`
}

HostCertificateAttributes is an ordinary certificate attributes description.

type HostCertificateExtension

type HostCertificateExtension struct {
	Data       string `json:"data"`
	Name       string `json:"name"`
	IsCritical bool   `json:"critical,omitempty"`
}

HostCertificateExtension represent single cert extension.

type HostCertificatePublicKey

type HostCertificatePublicKey struct {
	Type string `json:"type"`
	Bits int    `json:"bits"`
}

HostCertificatePublicKey holds type and bits length of the key.

type HostCipher

type HostCipher struct {
	Version string `json:"version"`
	Bits    int    `json:"bits"`
	Name    string `json:"name"`
}

HostCipher is a cipher description.

type HostDHParams

type HostDHParams struct {
	Prime       string     `json:"prime"`
	PublicKey   string     `json:"public_key"`
	Bits        int        `json:"bits"`
	Generator   *IntString `json:"generator"`
	Fingerprint string     `json:"fingerprint"`
}

HostDHParams is the Diffie-Hellman parameters if available.

type HostData

type HostData struct {
	Product      string                 `json:"product"`
	Hostnames    []string               `json:"hostnames"`
	Version      IntString              `json:"version"`
	Title        string                 `json:"title"`
	SSL          *HostSSL               `json:"ssl"`
	IP           net.IP                 `json:"ip_str"`
	OS           string                 `json:"os"`
	Organization string                 `json:"org"`
	ISP          string                 `json:"isp"`
	CPE          []string               `json:"cpe"`
	Data         string                 `json:"data"`
	ASN          string                 `json:"asn"`
	Port         int                    `json:"port"`
	HTML         string                 `json:"html"`
	Banner       string                 `json:"banner"`
	Link         string                 `json:"link"`
	Transport    string                 `json:"transport"`
	Domains      []string               `json:"domains"`
	Timestamp    string                 `json:"timestamp"`
	DeviceType   string                 `json:"devicetype"`
	Location     *HostLocation          `json:"location"`
	ShodanData   map[string]interface{} `json:"_shodan"`
	Opts         map[string]interface{} `json:"opts"`
}

HostData is all services that have been found on the given host IP.

type HostLocation

type HostLocation struct {
	City         string  `json:"city"`
	RegionCode   string  `json:"region_code"`
	AreaCode     int     `json:"area_code"`
	Latitude     float64 `json:"latitude"`
	Longitude    float64 `json:"longitude"`
	Country      string  `json:"country_name"`
	CountryCode  string  `json:"country_code"`
	CountryCode3 string  `json:"country_code3"`
	Postal       string  `json:"postal_code"`
	DMA          int     `json:"dma_code"`
}

HostLocation is the location of the host.

type HostMatch

type HostMatch struct {
	Total   int                 `json:"total"`
	Facets  map[string][]*Facet `json:"facets"`
	Matches []*HostData         `json:"matches"`
}

HostMatch is the search results with all matched hosts.

type HostQueryOptions

type HostQueryOptions struct {
	Query  string `url:"query"`
	Facets string `url:"facets,omitempty"`
	Minify bool   `url:"minify,omitempty"`
	Page   int    `url:"page,omitempty"`
}

HostQueryOptions is Shodan search query options.

type HostQueryTokens

type HostQueryTokens struct {
	Filters    []string               `json:"filters"`
	String     string                 `json:"string"`
	Errors     []string               `json:"errors"`
	Attributes map[string]interface{} `json:"attributes"`
}

HostQueryTokens is filters are being used by the query string and what parameters were provided to the filters.

type HostSSL

type HostSSL struct {
	Versions    []string           `json:"versions"`
	Chain       []string           `json:"chain"`
	DHParams    *HostDHParams      `json:"dhparams"`
	TLSExt      []*HostTLSExtEntry `json:"tlsext"`
	Cipher      *HostCipher        `json:"cipher"`
	Certificate *HostCertificate   `json:"cert"`
}

HostSSL holds ssl host information.

type HostServicesOptions

type HostServicesOptions struct {
	History bool `url:"history,omitempty"`
	Minify  bool `url:"minify,omitempty"`
}

HostServicesOptions is options for querying services.

type HostTLSExtEntry

type HostTLSExtEntry struct {
	ID   int    `json:"id"`
	Name string `json:"name"`
}

HostTLSExtEntry contains id and name.

type IntString

type IntString string

IntString is string with custom unmarshaling.

func (*IntString) String

func (v *IntString) String() string

String method just returns string out of IntString.

func (*IntString) UnmarshalJSON

func (v *IntString) UnmarshalJSON(b []byte) error

UnmarshalJSON handles either a string or a number and casts it to string.