Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chainguard-dev/kolide-google-matcher
Unearth host mismatches between Kolide & Google Workspace
https://github.com/chainguard-dev/kolide-google-matcher
compliance google kolide mdm soc2
Last synced: about 2 months ago
JSON representation
Unearth host mismatches between Kolide & Google Workspace
- Host: GitHub
- URL: https://github.com/chainguard-dev/kolide-google-matcher
- Owner: chainguard-dev
- License: apache-2.0
- Created: 2022-05-25T17:48:53.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-06-03T22:03:41.000Z (7 months ago)
- Last Synced: 2024-06-20T12:05:30.995Z (7 months ago)
- Topics: compliance, google, kolide, mdm, soc2
- Language: Go
- Homepage:
- Size: 230 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# kolide-google-matcher
Discover out-of-compliance hosts that have recently logged into Google Workspace, but lack a matching record in Kolide.
## Installation
```shell
go install github.com/chainguard-dev/kolide-google-matcher@latest
```
## Example Output
```log
2022/11/07 11:35:44 Kolide: found 60 devices
2022/11/07 11:35:44 Google: found 58 devices
2022/11/07 11:35:44 [email protected] mismatch: Google sees 2 macOS devices, Kolide sees 1
Google:
Inky's MacBookPro18,2 (MacOS 13.0.0) [Sep 2, 2022 to Nov 7, 2022]
Inky's Mac (macOS 10.15.7) [Sep 2, 2022 to Nov 6, 2022]
Kolide:
Inkys-MacBook-Pro-2 (macOS 13.0 Ventura Build: 22A380) [Sep 5, 2022 to Nov 7, 2022]
2022/11/07 11:35:44 [email protected] mismatch: Google sees 1 devices, Kolide sees 0!
Google:
Wolfi's Mac (macOS 10.15.7) [Nov 4, 2022 to Nov 4, 2022]
2022/11/07 11:35:44 found 2 total mismatches
```
## Requirements
* A Kolide API key [Create a New Key](https://k2.kolide.com/3361/settings/admin/developers/api_keys)
* Access to a Google Workspace admin console
* The Go Programming Language
## Usage
Gather the current list of Desktop machines according to Google:
1. Visit [Google Admin: Mobile Devices](https://admin.google.com/ac/devices/list?default=true&category=desktop)
2. Click the Download button (top right)
3. Select All columns
4. Select Comma-separated values (.csv)
5. Click "Download CSV"
Then you can run the `kolide-google-matcher`:
```shell
export KOLIDE_API_KEY="..."
$HOME/go/bin/kolide-google-matcher --endpoints-csv=
```