Skip to content

Add a given hyperlink to Cisco Umbrella ☂ using Enforcement API from PowerShell

Notifications You must be signed in to change notification settings

cbshearer/Add-URLtoUmbrella

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Add-URLtoUmbrella

To use this module

  • Import the module
PS C:\temp> Import-Module .\Add-URLtoUmbrella.psm1
  • If you want to install the module for long-term use
    • See Microsoft documentation.
    • Shortcut - just copy to its own folder in this location: $Env:ProgramFiles\WindowsPowerShell\Modules
PS C:\temp> copy .\Add-URLtoUmbrella.psm1 $Env:ProgramFiles\WindowsPowerShell\Modules\Add-URLtoUmbrella\Add-URLtoUmbrella.psm1
  • Line 17: API key
    • Follow instructions from Cisco Umbrella account to create an API key.

To use from CLI:

  • -u: URL
  • Examples
Add-URLtoUmbrella -u https://notverybelievable.com
Add-URLtoUmbrella -u https://www.scaryurl-for-badguys.org/malware/html/index.php,phishingexample.top

Operations

  • Enter any type of domain, with or without paths
    • The script manipulates the input to isolate the domain from input.
    • The script generates a URL from input by adding "http://" before the domain if protocol is not specified.
    • This is because both domain and URL are required by API for submission.
  • Script checks to see if the URL submitted is in the allow list you maintain: (https://github.com/cbshearer/Add-URLtoUmbrella/blob/master/AllowList.txt)
  • Umbrella Domain Acceptance Process already sorts the domains and compares against the Alexa top 1000

Output

  • Domain: the domain of your input
  • URL: the URL of your input (may be a composite made by prepending "http://"
  • Allowed?: Was this domain found on your allow list
  • Result: The domain is displayed and whether or not it was added to Cisco Umbrella successfully.

About

Add a given hyperlink to Cisco Umbrella ☂ using Enforcement API from PowerShell

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published