/SafeUrl

SafeUrl is a small and lite [FastAPI]( https://fastapi.tiangolo.com/) based web application intended to help us validate any URL safely before clicking it.

Primary LanguageHTMLApache License 2.0Apache-2.0

Please ⭐ this repo if you find it useful


PayPal

SafeUrl

Safely check the URL befor clicking it.

With the growing amount of Spam, Fishing, and Malicious messages, I needed a tool that would help me safely check the URL before I clicked it. Correct, there are other options like VirusTotal, but I wanted something more, like getting a Preview of the final URL or even getting IP Information of the hosted service, So I combined them all into one lite and simple application.

Features

With SafeUrl, you can get the following information:

  • Report Summary Using VirusTotal)
  • Report Info.
  • Site Preview
  • Website Info:
    • Final URL.
    • Redirect Chain (If there are redirections).
    • Outgoing Links.
    • HTML Meta information.
    • Trackers (Google Tag, Analytics, Pixels, and more).
    • Ip Information Using IpInfo.

Limatations

  • VirusTotal) free API is limited to 4 calls/minute.
  • IpInfo free API is limited to 50,000 calls/moneh.

Usage

In order to start working with SafeUrl, you need to register for free [VirusTotal)] (https://www.virustotal.com/gui/home/url) account and get a valid Free API Key. SafeUrl Index Page

Now, add the VirusTotal API key to the docker environment and you are ready to go.

Run from hub

docker-compose from hub

version: "3.6"
services:
  safeurl:
    image: techblog/safeurl
    container_name: safeurl
    restart: always
    ports:
      - "8080:8080"
    environment:
      - VT_API_KEY=[Your VirusTotal API Key] #Required
      - IPINFO_API_KEY=[Your IPInfo API Key] #Optional

Checking URL

So now, after you installed SafeURL, It's time to give it a try. Navigate to you server address and you shuold see the following screen:

SafeUrl Index Page

Enter the Requested URL and hit the "Check URL" button. The Scan process will start and then you will see the folllowing screen:

SafeUrl scan in progress

When the scan process will end, you will be able to see all the data collected during the scan process, Like Report summary: SafeUrl scan in progress

Site preview: SafeUrl scan in progress

And much much more.