defmodule Sobelow do @moduledoc """ Sobelow is a static analysis tool for discovering vulnerabilities in Phoenix applications. """ @v Mix.Project.config[:version] @submodules [Sobelow.XSS, Sobelow.SQL, Sobelow.Traversal, Sobelow.Misc, Sobelow.Config, Sobelow.CI] alias Sobelow.Utils alias Sobelow.Config alias Mix.Shell.IO # In order to support the old application structure, as well as the # upcoming application structure (ie all in lib directory, vs pulled # into a web directory), there are a number of different "roots" in # use. def run() do project_root = get_env(:root) <> "/" if !get_env(:private), do: version_check(project_root) app_name = Utils.get_app_name(project_root <> "mix.exs") if !is_binary(app_name), do: file_error() {web_root, lib_root} = get_root(app_name, project_root) root = if String.ends_with?(web_root, "./"), do: web_root <> "web/", else: lib_root if !File.exists?(web_root <> "web/router.ex"), do: file_error() ignored = get_ignored() allowed = @submodules -- ignored # Pulling out function definitions before kicking # off the test pipeline to avoid dumping warning # messages into the findings output. root_defs = Utils.all_files(root) |> Enum.reject(&is_nil/1) |> Enum.map(fn file -> {file, Utils.get_def_funs(root <> file)} end) # If web_root ends with the app_name, then it is the # more recent version of Phoenix. Meaning, all files are # in the lib directory, so we don't need to re-scan # lib_root separately. libroot_defs = case !String.ends_with?(web_root, "/#{app_name}/") do true -> Utils.all_files(lib_root) |> Enum.reject(&is_nil/1) |> Enum.map(fn file -> filename = lib_root <> file {filename, Utils.get_def_funs(filename)} end) _ -> [] end # This is where the core testing-pipeline starts. # # - Print banner # - Check configuration # - Remove config check from "allowed" modules # - Scan funcs from the root # - Scan funcs from the libroot IO.info print_banner() if Enum.member?(allowed, Config), do: Config.fetch(project_root, web_root) allowed = allowed -- [Config] Enum.each(root_defs, fn {filename, defs} -> defs |> Enum.each(&get_fun_vulns(&1, filename, root, allowed)) end) Enum.each(libroot_defs, fn {filename, defs} -> defs |> Enum.each(&get_fun_vulns(&1, filename, "", allowed)) end) IO.info "... SCAN COMPLETE ..." end def details() do mod = get_env(:details) |> get_mod if is_nil(mod) do IO.error "A valid module was not selected." else apply(mod, :details, []) end end def all_details() do @submodules |> Enum.each(&apply(&1, :details, [])) end def get_env(key) do Application.get_env(:sobelow, key) end defp print_banner() do """ ############################################## # # # Running Sobelow - v#{@v} # # Created by Griffin Byatt - @griffinbyatt # # NCC Group - https://nccgroup.trust # # # ############################################## """ end defp get_root(app_name, project_root) do lib_root = project_root <> "lib/" if File.exists?(project_root <> "lib/#{app_name}/web/router.ex") do {lib_root <> "#{app_name}/", lib_root} else {project_root <> "./", lib_root} end end defp get_fun_vulns(fun, filename, web_root, mods) do Enum.each mods, fn mod -> apply(mod, :get_vulns, [fun, filename, web_root]) end end defp file_error() do IO.error("This does not appear to be a Phoenix application.") System.halt(0) end defp version_check(project_root) do cfile = project_root <> ".sobelow" time = DateTime.utc_now() |> DateTime.to_unix() if File.exists?(cfile) do {timestamp, _} = case File.read!(cfile) do "sobelow-" <> timestamp -> Integer.parse(timestamp) _ -> file_error() end if time - 12*60*60 > timestamp do maybe_prompt_update(time, cfile) end else maybe_prompt_update(time, cfile) end end defp get_sobelow_version() do # Modeled after old Mix.Utils.read_path {:ok, _} = Application.ensure_all_started(:ssl) {:ok, _} = Application.ensure_all_started(:inets) {:ok, _} = :inets.start(:httpc, [{:profile, :sobelow}]) case :httpc.request('https://griffinbyatt.com/static/sobelow-version') do {:ok, {{_, 200, _}, _, vsn}} -> Version.parse! String.trim(to_string(vsn)) _ -> IO.error("Error fetching version number.\n") @v end after :inets.stop(:httpc, :sobelow) end defp maybe_prompt_update(time, cfile) do installed_vsn = Version.parse! @v cmp = get_sobelow_version() |> Version.compare(installed_vsn) case cmp do :gt -> IO.error """ A new version of Sobelow is available: mix archive.install hex sobelow """ _ -> nil end timestamp = "sobelow-" <> to_string(time) File.write(cfile, timestamp) end def get_mod(mod_string) do case mod_string do "XSS" -> Sobelow.XSS "XSS.Raw" -> Sobelow.XSS.Raw "XSS.SendResp" -> Sobelow.XSS.SendResp "SQL" -> Sobelow.SQL "SQL.Query" -> Sobelow.SQL.Query "SQL.Stream" -> Sobelow.SQL.Stream "Misc" -> Sobelow.Misc "Misc.BinToTerm" -> Sobelow.Misc.BinToTerm "Config" -> Sobelow.Config "Config.CSRF" -> Sobelow.Config.CSRF "Config.Secrets" -> Sobelow.Config.Secrets "Config.HTTPS" -> Sobelow.Config.HTTPS "Traversal" -> Sobelow.Traversal "Traversal.SendFile" -> Sobelow.Traversal.SendFile "Traversal.FileModule" -> Sobelow.Traversal.FileModule "CI" -> Sobelow.CI "CI.System" -> Sobelow.CI.System "CI.OS" -> Sobelow.CI.OS _ -> nil end end def get_ignored() do get_env(:ignored) |> Enum.map(&get_mod/1) end end