https://github.com/danzek/gadhash
CLI to calculate Google Analytics domain hash given list of domains
https://github.com/danzek/gadhash
Last synced: about 1 year ago
JSON representation
CLI to calculate Google Analytics domain hash given list of domains
- Host: GitHub
- URL: https://github.com/danzek/gadhash
- Owner: danzek
- License: mit
- Created: 2017-09-25T03:23:54.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2018-07-10T07:12:45.000Z (about 8 years ago)
- Last Synced: 2025-04-13T16:09:48.119Z (about 1 year ago)
- Language: C++
- Size: 12.2 MB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# `gadhash`: Google Analytics Domain Hash Calculator
Calculates Google Analytics domain hash given domain(s).
### Contents
- [Overview](#overview)
- [Building](#building)
- [Dependencies](#dependencies)
- [CMake](#cmake)
- [Usage](#usage)
- [Rainbow Tables](#rainbow-tables)
- [Contributing](#contributing)
- [License, Disclaimers, etc.](#license-disclaimers-etc)
## Overview
When analyzing Google Analytics cookies, you will see an Urchin Tracking Module A (UTMA) value (utma=) in the URL. The part for comparison is only the number before the first dot ("."). For instance, in "utma=173272373.nnnnn...", the domain hash is 173272373 ("google.com", where n is any arbitrary number).
Enter only the domain (without the protocol, i.e. don't include "`http://`") so that the domain hash will be calculated correctly. A hash value of 0 indicates an error.
This is a C++ CLI related to [the Windows GUI C# version I wrote previously](https://github.com/danzek/google-analytics-domain-hash-calculator).
## Building
`gadhash` has a single `main.cpp` file that contains all of the application code. As such, you can build the application using any compiler you are comfortable with that has C++11 support. CMake has been used to remain compiler-independent.
### Dependencies
The following **Boost 1.61.0 libraries** are ***required*** dependencies for `gadhash`:
- Boost.Program_options
- Boost.Iostreams
See [the Boost documentation for getting started on *nix.](http://www.boost.org/doc/libs/1_61_0/more/getting_started/unix-variants.html) (there is also [instructions for Windows](http://www.boost.org/doc/libs/1_61_0/more/getting_started/windows.html) but note that `gadhash` intentionally targets Linux platforms—I also wrote [a Windows GUI version](https://github.com/danzek/google-analytics-domain-hash-calculator), though, FYI).
### CMake
[Install CMake](https://cmake.org/install/) 3.8 or higher (if you don't already have it). This is a fairly new version so it may not be available in some package repositories. I recommend [downloading it from cmake.org](http://cmake.org/download/) and [following their installation instructions](https://cmake.org/install/).
Once you have CMake installed, you can generate a Makefile for your platform by invoking `cmake` and providing the path to the `CMakeLists.txt` file at the root of this repository. For example:
cmake ~/Documents/gadhash/CMakeLists.txt
This will generate a Makefile which you can then use to build the software:
make
This should result in a compiled binary being created for your system. You can also run `make install` if you choose to after this.
Alternatively, you can just run `cmake --build [/path/to/CMakeLists.txt]` and it should build regardless of the build system on your platform (especially useful if it doesn't support `make`).
## Usage
gadhash expects a file (or `stdin`) containing a list of domains separated by newlines (`\n`; *not* `\r`—be sure to use UNIX/LF line endings).
gadhash [OPTION(s)] [FILE(s)]
Options:
-h [ --help ] get usage help
-v [ --version ] display version
-d [ --delimiter ] arg (=,) specify output delimiter string (comma/CSV by
default; can be multiple characters)
-f [ --file ] arg file(s) containing list of domains (one per
line); gadhash reads stdin if no file(s)
specified or a hyphen ('-') is given
If no options or file names are specified, gadhash will read from `stdin`.
:warning: This uses `std::string` and assumes UTF-8 (POSIX)—I made no attempt to deal with wide characters (neither `std::wstring` nor `wchar_t`) nor alternate line endings (CR, i.e. `\r`) to support Windows. **I only intended for this to work on Linux.** That said, feel free to fork this code and make it support whatever you want it to! Keep in mind I already wrote [a Windows GUI version of this tool](https://github.com/danzek/google-analytics-domain-hash-calculator) (if there is interest, I can make that one support file input containing a list of domains, too).
## Rainbow Tables
["Rainbow tables" of hashed domains have been made available](https://github.com/danzek/gadhash/tree/master/rainbowtbl) using `gadhash` to compute the Google Analytics (GA) domain hashes. This will enable interested parties to query a domain hash to find the corresponding domain.
## Contributing
I welcome contributions. Contact me at d@4n68r.com, create an issue, and/or fork this code and create a pull request.
## License, Disclaimers, etc.
*MIT License*
Copyright © 2017 Dan O'Day (d@4n68r.com)
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
This project uses the `Boost` libraries for CLI argument parsing and memory-mapping files. Boost is distributed under the Boost Software License, Version 1.0 (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt).
The hash function is based on [a StackOverflow answer](https://stackoverflow.com/a/16243868/) posted by user [Nico Westerdale](https://stackoverflow.com/users/768732/nico-westerdale) to [this question](https://stackoverflow.com/q/4821627/) posted by user [Alex Wayne](https://stackoverflow.com/users/62076/alex-wayne) (the answer is written in C#). StackOverflow user contributions are licensed under [cc by-sa 3.0](https://creativecommons.org/licenses/by-sa/3.0/) with [attribution required](https://stackoverflow.blog/2009/06/25/attribution-required/).