{"id":18676167,"url":"https://github.com/foospidy/sigsci-sounds","last_synced_at":"2025-04-12T02:12:39.261Z","repository":{"id":57611210,"uuid":"77536145","full_name":"foospidy/sigsci-sounds","owner":"foospidy","description":"Listen to the soothing sounds of attacks and anomalies detected by the Signal Sciences web protection platform.","archived":false,"fork":false,"pushed_at":"2018-10-01T14:11:39.000Z","size":18703,"stargazers_count":10,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-12T02:12:32.712Z","etag":null,"topics":["anomaly","api","attack","go","golang","monitoring","rasp","signal-sciences","signal-sciences-api","signalsciences","sigsci","sound","waf"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/foospidy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-12-28T13:51:20.000Z","updated_at":"2022-09-23T09:10:08.000Z","dependencies_parsed_at":"2022-09-11T11:11:50.389Z","dependency_job_id":null,"html_url":"https://github.com/foospidy/sigsci-sounds","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foospidy%2Fsigsci-sounds","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foospidy%2Fsigsci-sounds/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foospidy%2Fsigsci-sounds/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foospidy%2Fsigsci-sounds/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/foospidy","download_url":"https://codeload.github.com/foospidy/sigsci-sounds/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248505926,"owners_count":21115354,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anomaly","api","attack","go","golang","monitoring","rasp","signal-sciences","signal-sciences-api","signalsciences","sigsci","sound","waf"],"created_at":"2024-11-07T09:27:58.051Z","updated_at":"2025-04-12T02:12:39.233Z","avatar_url":"https://github.com/foospidy.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sigsci-sounds\n\nListen to the soothing sounds of attacks and anomalies.\n\n[![Build Status](https://travis-ci.org/foospidy/sigsci-sounds.svg?branch=master)](https://travis-ci.org/foospidy/sigsci-sounds)\n[![Go Report Card](https://goreportcard.com/badge/github.com/foospidy/sigsci-sounds)](https://goreportcard.com/report/github.com/foospidy/sigsci-sounds)\n\n## Description\n\nThe [Signal Sciences](https://signalsciences.com) web protection platform offers a rich API that enables limitless integrations and automation. Or, at least only limited by your imagination. As an example of this, sigsci-sounds is a utility to audibility monitor when Signal Sciences detects attack or anomaly events against your web site. You literally can listen to your site being attacked.\n\nThe utility is configurable so you can define which attacks or anomalies you want to hear.\n\nNote: obviously you must be a Signal Sciences customer to make use of this utility.\n\n## Requirements\n\n- Golang 1.7 or higher.\n- A Signal Sciences API account.\n\n## Instructions\n\n__Be sure to have your `GOPATH` set properly.__\n\nIf you have `make` on your system run `make all` to build the binary. Once built, you can run `./sigsci-sounds`. Or you can run `make run` to run sigsci-sounds without building the binary. If you do not have `make`, You can run `go build -i sigsci-sounds.go` to build the binary.\n\n### Configure SigSci API Info\n\nWhen accessing the [Signal Sciences API](https://docs.signalsciences.net/api/) you need to specify your credentials (email and password), corp name, and site name. You can do this via environment variables, example:\n\n```bash\nexport SIGSCI_EMAIL=\u003cyour email\u003e\nexport SIGSCI_PASSWORD=\u003cyour password\u003e\nexport SIGSCI_CORP=\u003cyour corp name\u003e\nexport SIGSCI_SITE=\u003csite name of site to be monitored by sigsci-sounds\u003e\n```\n\n### Configure sigsci-sounds Themes\n\nBy default sigsci-sounds will use the theme file `themes/sigsci-sounds-osx.conf`. However, you can use a different theme by setting the `SIGSCI_SOUNDS_CONFIG` environment variable, e.g. `export SIGSCI_SOUNDS_CONFIG=theme/star-trek-tos.conf`.\n\nNote: You can edit theme files and include your API information (email, password, corp, site), rather than setting those values as environment variables.\n\n## Themes\n\nYou can edit and create themes!\n\nThe theme file is JSON format. See one of the provided [configuration files](https://github.com/foospidy/sigsci-sounds/blob/master/themes/star-trek-tos.conf) as an example.\n\nTo customize a theme you only need to edit the `\"Tags\": []` section of the file. This section is a JSON array where each entry requires two fields: name and sound.\n\n- __name__ is the actual tag \"short name\" you want to monitor. This can be a Signal Sciences default sytem tag or a custom tag.\n- __sound__ is the path to the sound file you want to play for the specified tag name.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoospidy%2Fsigsci-sounds","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffoospidy%2Fsigsci-sounds","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoospidy%2Fsigsci-sounds/lists"}