Skip to content
This repository has been archived by the owner on Apr 4, 2022. It is now read-only.
/ ApertaCookie Public archive

ApertaCookie is a PowerShell module that can extract and decrypt cookie data from the SQLite databases of several popular browsers.

License

Notifications You must be signed in to change notification settings

techthoughts2/ApertaCookie

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ApertaCookie - ARCHIVED

Minimum Supported PowerShell Version PowerShell Gallery Cross Platform License

Branch Windows Linux MacOS
main ApertaCookie-Windows-pwsh-Build-main ApertaCookie-Linux-Build-main ApertaCookie-MacOS-Build-main
Enhancements ApertaCookie-Windows-pwsh-Build-Enhancements ApertaCookie-Linux-Build-Enhancements ApertaCookie-MacOS-Build-Enhancements

This project is no longer actively maintained

04/03/2022 - I have decided to archive this project. The module is also now unlisted on the PSGallery. Primary reasons:

  1. I lack the necessary .NET skill set for making this module truly cross-platform. A firm understanding of System.Security.Cryptography in .NET Core is necessary to achieve this.
  2. It is extremely challenging to keep pace with browser changes and the way they store and interact with cookies. This module breaks constantly as a result.

If you are interested in picking up this project, feel free to reach out to me on Twitter.

Synopsis

ApertaCookie is a PowerShell module that can extract and decrypt cookie data from the SQLite databases of several popular browsers.

Description

ApertaCookie enables you to quickly extract the cookies from a browser's SQLite database using PowerShell.

Edge, Chrome, and Firefox are currently supported across Windows, Linux, and MacOS for retrieving raw cookie information. With the exception of Firefox, cookie values are encrypted. Cookie value decryption is currently supported on Windows OS.

ApertaCookie provides the following functions:

Cross-platform Cookie Decryption Support

ApertaCookie aims to be a fully cross-platform module. For Firefox, it currently is. Unfortunately, while you can still pull raw cookie information on Linux and MacOS, cookie value decryption is not currently possible. See the issues tab if you have experience with PBKDF2 and .NET Core System.Security.Cryptography to see how you can improve ApertaCookie!

OS Edge Chrome Firefox
Windows ✔️ no decrypt required
Linux ✔️ no decrypt required
MacOS ✔️ no decrypt required

Why

Using PowerShell you can now quickly query the cookies database of several browsers. You can also quickly load desired cookies into a websession for a variety of use cases.

Installation

Prerequisites

Installing ApertaCookie via PowerShell Gallery

#from a 7.0.0+ PowerShell session
Install-Module -Name "ApertaCookie" -Scope CurrentUser

Quick start

#------------------------------------------------------------------------------------------------
# import the ApertaCookie module
Import-Module -Name "ApertaCookie"
#------------------------------------------------------------------------------------------------
# get raw cookie information from chrome - cookie values are encrypted
$allChromeCookies = Get-RawCookiesFromDB -Browser Chrome
#------------------------------------------------------------------------------------------------
# get decrypted cookie information from edge
$edgeCookies = Get-DecryptedCookiesInfo -Browser Edge
#------------------------------------------------------------------------------------------------
# get decrypted cookie information from edge for a specific domain
$edgeCookies = Get-DecryptedCookiesInfo -Browser Edge -Domain facebook
#------------------------------------------------------------------------------------------------
# get decrypted cookie infromation from firefox for the twitter domain and load into a web session
$session = Get-DecryptedCookiesInfo -Browser Firefox -DomainName twitter -WebSession
#------------------------------------------------------------------------------------------------
# get information about various cookie time values
Convert-CookieTime -CookieTime 13267233550477440
# for firefox cookies specify the firefox switch
Convert-CookieTime -CookieTime 1616989552356002 -FirefoxTime
#------------------------------------------------------------------------------------------------

Author

Jake Morrison - https://www.techthoughts.info/

Notes

This PowerShell project was created with Catesta.

License

This project is licensed under the MIT License.

Changelog

Reference the Changelog

About

ApertaCookie is a PowerShell module that can extract and decrypt cookie data from the SQLite databases of several popular browsers.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published