Project

osakana

0.01
Repository is archived
No commit activity in last 3 years
No release in over 3 years
A Swiss army knife for the phishing research.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.0
~> 0.8
~> 12.3
~> 3.8
~> 4.0
~> 3.5

Runtime

~> 0.2
~> 4.1
~> 0.1
~> 0.1
~> 0.19
 Project Readme

Osakana

Gem Version Build Status Coverage Status

Osakana is a Swiss army knife tool for my phishing research.

Features

  • Lookup supports:
    • Ayashige lookup
    • Censys lookup
    • DNPedia (newly registered domains) lookup
    • urlscan.io lookup
  • IoC enrichment:
    • SecurityTrails integration (an API Key is required)
    • Robtex integration
  • Notification:
    • Slack notification

Prerequisites

  • Ruby (> 2.5)

Install

gem install osakana

Usage

$ osakana
Commands:
  osakana ayashige_lookup [KEYWORD]      # lookup on Ayashige by a given keyword
  osakana censys_lookup [QUERY]          # lookup on Censys by a given query
  osakana check_newly_domains [KEYWORD]  # check newly registered domains on DNPedia by a given keyword
  osakana help [COMMAND]                 # Describe available commands or one specific command
  osakana urlscan_lookup [QUERY]         # look up on urlscan.io by a given query

Configuration

Censys

Please set the following environmental variables for enabling Censys lookup.

  • CENSYS_ID: your Censys API ID
  • CENSYS_SECRET: your Censys secret key

SecurityTrails

Please set the following environmental variable for enabling SecurityTrails integration.

  • SECURITYTRAILS_API_KEY: your SecurityTrails API key

Slack

Please set the following environmental variables for enabling Slack notification.

  • SLACK_WEBHOOK_URL: A Slack webhook URL.
  • SLACK_CHANNEL_NAME: A Slask channel name which will be notified.

Screenshots

osakana censys_lookup

censys

osakana check_newly_domains

dnpedia