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
2025
2026
 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