Project

interactsh

0.0
The project is in a healthy, maintained state
Ruby client library for Interactsh - a tool for detecting out-of-band interactions
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Runtime

~> 1.2, >= 1.2.0
~> 1.0, >= 1.0.7
 Project Readme

InteractSH-Library

Ruby library for Interactsh

Installation

gem install interactsh

Available method

Interactsh::Client.new        # => Initialize a new InteractSH class | [Object]
Interactsh::Client.new_domain # => Generate a new domain | [String]
Interactsh::Client.poll       # => Retrieves data from the server for a specific domain | [Hash]

Working with custom server

Interactsh.new accepts your custom domain as an argument. See Custom Interactsh Server Installation

Interactsh::Client.new('domain.tld')
Interactsh::Client.new('domain.tld', 'your-secret-token')

Usage example :

require 'interactsh'
require 'net/http'

# Initialize client
client = Interactsh::Client.new

# Generate unique interaction domain
domain = client.new_domain
puts "Generated domain: #{domain}"

# Simulate an HTTP request to the domain
uri = URI("http://#{domain}")
response = Net::HTTP.get_response(uri)
puts "Made HTTP request to #{domain}"

# Poll for interactions
puts "Polling for interactions..."
interactions = client.poll(domain)

# Process interactions
interactions.each do |interaction|
  puts "Request type: '#{interaction['protocol']}' from '#{interaction['remote-address']}' at #{interaction['timestamp']}"
  puts "Full interaction data: #{interaction.inspect}"
end