deardaniel/secdata-raw huggingface dataset:
Velociraptor DFIR platform: README

# Elastic ECS support

[Elastic Common
Schema](https://www.elastic.co/guide/en/ecs/current/index.html) is an
Elastic/Opensearch database schema which normalizes event data into
the database. It is commonly used within the Elastic/Opensearch
ecosystem. Certain log forwarding agents (e.g. Winlogbeats) transform
the raw event data into ECS formatted objects. This mostly requires
renaming fields and adding some enrichments.

Velociraptor can also produce ECS compatible objects using the
`Elastic.EventLogs.Sysmon` artifact which may be forwarded to an
Elastic database.

This document explains how to initialize your indexes to support
Elastic ECS uploads.

## Using Curl to upload the index patten

Although Elastic by default infers the schema based on the first
document uploaded (So called `dynamic mapping`) this should be avoided
because it often gets it wrong and then rejects further events that do
not comply with the guessed schema.

Therefore it is advisable to initialize the schema manually. The best
way is using an "index template". This automatically initializes the
schema for all indexes that match the template (see the
`index_patterns` field in the schema)

You can upload an index template with curl using a JSON template in
this repository:

```bash
curl -kn -X PUT "localhost:9200/_index_template/winlogbeat-1" -H 'Content-Type: application/json' -d'@winlogbeat_schema.json'
```

NOTE: This index template was obtained from winlogbeats using the
following command

```bash
winlogbeat export template --es.version 8.11.1
```

But the index was modified to remove all fields with the `flattened`
type which is not supported in opensearch. Therefore this index
template is fully compatible with opensearch as well.

Once the index template is uploaded you can create an index an index
using this curl command:

```
curl -kn -X PUT "localhost:9200/_data_stream/winlogbeat-velo"
```

Note that the default template uses a data stream which is more
efficient for insertions but objects can not be deleted from the
index.

## Delete the index

To delete the entire index you can use the following curl command:

```
curl -kn -X DELETE "localhost:9200/_data_stream/winlogbeat-velo" -H 'Content-Type: application/json'
```

## Viewing the data

As data is inserted into the index, you can inspect it manually

```
curl -kn -X GET "localhost:9200/winlogbeat-velo/_search?pretty" | less
```

But normally you would use something like Kibana to interact with the
data.
Velociraptor DFIR platform: README

A quick script to detect new config fields which are not documented in
the sample server config file.

Run this periodically to update the reference documentations.
Velociraptor DFIR platform: README

# Velociraptor GUI development

This directory contains the source code for the Velociraptor GUI.

## Setting up a dev platform.

To build the web app you need to first install dependencies using npm:

```
npm install
```

Then start the Velociraptor server. NOTE: By default Velociraptor
listens on SSL and node does not. Therefore the CSRF cookies (which
are marked secure) are not properly set. For testing and development
you can switch CSRF protection off.

```
export VELOCIRAPTOR_DISABLE_CSRF=1
velociraptor --config server.config.yaml frontend -v
```

Now you can start the node server:
```
npm run start
```

The development setup starts a node server listening on port 3000, and
proxies the API requests to the Velociraptor server, which by default is
expected to be listening on port 8889.

If you want the API requests to be forwarded to a remote server or on a
different port then edit the value of `server.proxy` in vite.config.js.

The node dev server will rebuild the application and automatically refresh
it each time a source file is edited.
Velociraptor DFIR platform: README

# Updating and maintaining the language files

There is a script that can be used to maintain translation files:

1. run the script on each language file:

```
$ python3 scripts/find_i8n_translations.py ./gui/velociraptor/src/components/i8n/de.jsx
Wrote json file ./gui/velociraptor/src/components/i8n/de_new.json with 6 entries
Wrote automated json file ./gui/velociraptor/src/components/i8n/de_automated.json with 163 entries
```

This will generate a number of files for each language:

* The `.jsx` file will be included in the build. That file contains
  *curated* translations that a fluent speaker in the language has
  verified. e.g. `de.jsx`

* The `de.json` file contains automated translations- the keys are
  obfuscated as hex encoding in order to protect them from Google
  translate. The GUI will use these translations in addition to the
  ones in `de.jsx`.

* The `de_new.json` file contains additional translations the script
  above has detected are missing. This JSON file contains a keys that
  are obfuscated hex encoded and values are English language phrases
  to be translated.

  When new words are found, you should copy the JSON object from
  `de_new.json` into Google translate and select the relevant target
  language. Then copy the translated strings back into `de.json`. For
  example, `de_new.json` might contain

```
    "436c69636b20746f[PII_REDACTED]206f[PII_REDACTED]74": "Click to view or edit",
```
  Paste this in Google translate and copy the translation back to `de.json`:

```
    "436c69636b20746f[PII_REDACTED]206f[PII_REDACTED]74": "Zum Anzeigen oder Bearbeiten klicken",
```

  Running the script again will remove the translation from
  `de_new.json`. We aim to have an empty `de_new.json` as all
  translations will be added to `de.json`

* Ideally we consider automated translations to be inferior to
  manually audited translations made by fluent speakers of the target
  language. Therefore we aim to eventually move automated translations
  to `de.jsx` after review. The above script creates
  `de_automated.json` containing English keys and target language
  values for review by fluent speakers.

  If you are a fluent speaker, simply review the translations in
  `de_automated.json` and copy the corrected translations directly
  into `de.jsx`. You can then remove these from `de.json`


So to summarize:

1. The highest confidence translations are in `de.jsx` and were
   reviewed by a fluent speaker of the target language.
2. Automated translations are added to that in `de.json` after being
   translated by Google translate.
3. The above script audits the source code each time it is run for
   missing translations, adding then to `de_new.json`.
4. If you are a maintainer, feed `de_new.json` into Google translate
   and save the results in `de.json`
5. If you are a native speaker, review `de_automated.json` and paste
   the translations in `de.jsx` directly, while removing them from
   `de.json`


NOTE: This entire process can be achieved using `make translations`
Velociraptor DFIR platform: README

# Interactive configuration wizard.

The aim of the wizard is to make it easy to configure Velociraptor in
the most common deployment scenarios. Even though these scenarios will
not be a perfect fit for everyone, most users should be able to start
with these deployment modes and tweak the configuration to their
specific needs.

Although it is possible to mix and match configurations (for example
SSO with self signed certificates), the wizard does not offer these
combinations. We want to keep it as simple as possible and so minimize
choice to the most common choices.

There are currently 3 separate deployment types:

1. Self Signed:
  * Frontend will listen on port 8000 with self signed TLS certificate
  * GUI will listen on port 8889 with self signed TLS certificate
  * Basic authentication: Velociraptor will manage passwords for user accounts.

2. AutoCert:
  * Frontend and GUI are both listening with TLS on port 443
  * Certificates will be automatically minted with Let's Encrypt.
  * Basic authentication: Velociraptor will manage passwords for user accounts.

3. AutoCert with SSO
  * Frontend and GUI are both listening with TLS on port 443
  * Certificates will be automatically minted with Let's Encrypt.
  * SSO will be performed with OAuth using one of the most common providers:
     * Google
     * Azure
     * GitHub
     * Generic OIDC provider

## Breaking configuration questions by category

The Wizard goes through the configuration process grouping questions
by category

### Server Configuration

This configures the server itself, where to store the data, Frontend
host names etc.

Questions include:

* The type of deployment (Self Signed, AutoCert or AutoCert With SSO)
* Server Platform OS
* Data store paths
* Logging directories
* Internal PKI Expiration Time
* Add default plugin allow list

### Network configuration

This section configures the server's network parameters.

Questions include:
* Public DNS of the server frontend
* Optional features:
   * Built in Dynamic DNS updater if required.
   * Enable Websocket

If we are in Self Signed mode, the ports may be further configured:
* Frontend Listening port
* GUI Listening port

AutoCert modes must listen on ports 443 due to Let's Encrypt
limitations.

If the User selected the internal DNS Updater we also ask questions
about it:

For NOIP:
* NoIP DynDNS Username
* NoIP DynDNS Password

For Cloudflare
* Cloudflare Zone Name
* Cloudflare API Token

### Authentication configuration

This section configures the authentication providers

For Google or GitHub:
* OAuth Client ID
* OAuth Client Secret

For Azure an additional question:
* Tenant ID

For Generic OIDC:
* OIDC Issuer URL

Adding default administrators
OWASP API Security Top 10: README

# OWASP API Security Top 10

This project is designed to address the ever-increasing number of organizations
that are deploying potentially sensitive APIs as part of their software
offerings. These APIs are used for internal tasks and to interface with third
parties. Unfortunately, many APIs do not undergo the rigorous security testing
that would help make them secure from an attack.

The OWASP API Security Project seeks to provide value to software developers and
security assessors by underscoring the potential risks in insecure APIs, and
illustrating how these risks may be mitigated. In order to facilitate this goal,
the OWASP API Security Project will create and maintain a Top 10 API Security
Risks document, as well as a documentation portal for best practices when
creating or assessing APIs.

## Description

While working as developers or information security consultants, many people
have encountered APIs as part of a project. While there are some resources to
help create and evaluate these projects (such as the OWASP REST Security Cheat
Sheet), there has not be a comprehensive security project designed to assist
builders, breakers, and defenders in the community.

This project aims to:

* Create the OWASP Top Ten API Security Risks document, which can easily
  underscore the most common risks in the area.
* Create a documentation portal for developers to build APIs in a secure manner.
* Work closely with the security community to maintain living documents that
  evolve with security trends.

## Project Leaders

* [Erez Yalon][0]
* [Inon Shkedy][5]
* [Paulo Silva][6]

## Licensing

**The OWASP API Security Project documents are free to use!**

The OWASP API Security Project is licensed under the [Creative Commons
Attribution-ShareAlike 4.0 license][1], so you can copy, distribute, and
transmit the work. You can also adapt it, and use it commercially, as long as
you attribute the work. If you alter, transform, or build upon this work, you
may distribute the resulting work only under the same or similar license to this
one.

[0]: https://www.owasp.org/index.php/User:ErezYalon
[1]: http://creativecommons.org/licenses/by-sa/4.0/
[2]: https://github.com/OWASP/API-Security/blob/develop/2019/en/dist/owasp-api-security-top-10.pdf
[3]: https://github.com/OWASP/API-Security/tree/develop/
[4]: https://github.com/OWASP/API-Security/blob/master/CONTRIBUTING.md
[5]: https://www.owasp.org/index.php/User:Inon
[6]: mailto:paulo.silva@owasp.org
[cfd-2022]: https://owasp.org/www-project-api-security/announcements/cfd/2022/
OWASP API Security Top 10: SECURITY

# Security Policy 
  
 ## Supported Versions 
  
 This repository contains documentation and educational content. 
 There are no executable components or deployed services associated with this project. 
  
 The `master` branch reflects the latest maintained version of the documentation. 
  
 | Version | Supported | 
 |--------|-----------| 
 | master | ✅ | 
 | Others | ❌ | 
  
 --- 
  
 ## Reporting a Vulnerability 
  
 This repository does **not** directly process user data, authentication, or runtime execution. 
 However, if you believe you have identified: 
  
 - A security issue affecting linked tooling or referenced examples 
 - A misconfiguration that could lead to unsafe usage patterns 
 - A vulnerability related to CI/CD workflows or repository automation 
  
 Please follow **responsible disclosure** practices. 
  
 ### How to Report 
 - Open a **private GitHub Security Advisory** for this repository, **or** 
 - Contact the OWASP project maintainers through official OWASP communication channels 
  
 Please include: 
 - A clear description of the issue 
 - Steps to reproduce (if applicable) 
 - Potential impact 
 - Suggested remediation (if available) 
  
 --- 
  
 ## Disclosure Process 
  
 - Reports will be reviewed by project maintainers 
 - If applicable, fixes will be discussed and implemented 
 - Public disclosure may occur after remediation, with reporter credit if desired 
  
 --- 
  
 ## Security Best Practices for Contributors 
  
 - Do not include secrets, tokens, or credentials in documentation or workflows 
 - Avoid using user-controlled input in CI/CD pipelines without validation 
 - Follow the OWASP Cheat Sheet Series for secure development and governance practices 
  
 --- 
  
 ## Recognition 
  
 Security researchers and contributors who responsibly disclose issues may be acknowledged 
 in release notes or project documentation, unless anonymity is requested.
OWASP API Security Top 10: 0x00 notice

# Примечание

Это текстовая версия OWASP API Security Top 10, используемая для создания официальной версии, распространяемой в формате PDF.

Содействие в проекте, например, комментарии, исправления или перевод должны быть сделаны здесь. За подробностями о [cодействии][1] обратитесь к [CONTRIBUTING.md][1].

* Erez Yallon
* Inon Shkedy

[1]: ../../../CONTRIBUTING.md
OWASP API Security Top 10: 0xd0 about data

# Методология и данные

## Обзор

Поскольку индустрия AppSec не сфокусирована главным образом на новейшей архитектуре приложений, в которой API играют важную роль, составление списка из десяти наиболее критичных рисков безопасности API на базе публичного сбора данных - сложная задача. Несмотря на отсутствие публичного сбора данных, получившийся список все равно основан на общедоступной информации, вкладе экспертов по безопасности и открытых дискуссиях сообщества по безопасности.

## Методология

На первом этапе группа экспертов по безопасности собрала, проанализировала и категоризировала публичные данные об инцидентах безопасности в API. Эти данные были собраны с площадок bug bounty площадок и баз данных уязвимостей за последний год. Этот временной промежуток выбран для удобства расчета статистики.

Затем эксперты по безопасности с опытом тестирования на проникновение составили свой список 10-ти наиболее критичных рисков.

[Методология ранжирования рисков OWASP][1] была использована в ходе анализа рисков. Эксперты по безопасности проанализировали результаты. Чтобы узнать о рассуждениях на эту тему обратитесь к секции [Риски безопасности API][2].

Первый черновик OWASP API Security Top 10 2019 был составлен на базе статистических результатов первого этапа и списков, созданных экспертами по безопасности. Этот черновик был отправлен для проверки и анализа другой группе экспертов по безопасности с достаточным опытом в сфере безопасности API.

OWASP API Security Top 10 2019 впервые был представлен на конференции OWASP Global AppSec Tel Aviv в мае 2019 года. С тех пор он доступен на GitHub для публичного обсуждения и содействия.

Список участников, внесших свой вклад, доступен в секции [Благодарность][3].

[1]: https://www.owasp.org/index.php/OWASP_Risk_Rating_Methodology
[2]: ./0x10-api-security-risks.md
[3]: ./0xd1-acknowledgments.md
OWASP API Security Top 10: 0x00 header

---
title: ''
---

![OWASP LOGO](images/owasp-logo.png)

# OWASP API Security Top 10 2019

Десять наиболее критичных рисков безопастности API

29 Мая 2019 года

![OWASP Logo URL TBA](images/front-wasp.png)

| | | |
| - | - | - |
| https://owasp.org | В соответствии с лицензией [Creative Commons Attribution-ShareAlike 4.0 International License][1] | ![Creative Commons License Logo](images/front-cc.png) |

[1]: http://creativecommons.org/licenses/by-sa/4.0/
OWASP API Security Top 10: 0x02 foreword

# Предисловие

Программный интерфейс приложений (API) - фундаментальный элемент инноваций в современном, движимом приложениями мире. API - важная составляющая современных мобильных, SaaS и веб приложений, используемая в клиентских, партнерских и внутренних приложениях от банковской сферы, сфер розничных продаж и логистики до интернета вещей, автономных автомобилей и умных городов.

По своей природе API раскрывают логику приложения и критичные данные, например, персональные данные, именно поэтому API все чаще становятся целью злоумышленников. Стремительные инновации невозможны без безопасных API.

Несмотря на то, что более обширный Web Application Security Risks Top 10 по прежнему актуален, ввиду специфики API, необходим отдельный список рисков безопасности специфичных для API. Безопасность API фокусируется на стратегиях и решениях, направленных на понимание и предотвращение уникальных уязвимостей и рисков безопасности, связанных с использованием API.

Если вы уже знакомы с [OWASP Top 10 Project][1], то наверняка заметите сходства с настоящим документом, их основная цель - улучшение читаемости и повышение частоты использования настоящего документа. Если вы не знакомы с семейством OWASP Top 10, то рекомендуем сначала ознакомиться с секциями [Риски Безопасности API][2] и [Методология и Данные][3] перед погружением в список Top 10.

Вы можете посодействовать OWASP API Security Top 10 своими вопросами, комментариями и идеями в нашем репозитории GitHub:

* https://github.com/OWASP/API-Security/issues
* https://github.com/OWASP/API-Security/blob/master/CONTRIBUTING.md

Вы можете ознакомиться с OWASP API Security Top 10 здесь:

* https://www.owasp.org/index.php/OWASP_API_Security_Project
* https://github.com/OWASP/API-Security

Мы хотим поблагодарить всех участников проекта, которые своим вкладом и стараниями помогли проекту свершиться. Все они перечислены в секции [Благодарность][4]. Спасибо вам!

[1]: https://www.owasp.org/index.php/Category:OWASP_Top_Ten_Project
[2]: ./0x10-api-security-risks.md
[3]: ./0xd0-about-data.md
[4]: ./0xd1-acknowledgments.md
OWASP API Security Top 10: 0x03 introduction

# Введение

## Добро пожаловать в OWASP API Security Top 10 - 2019!

Добро пожаловать в первую версию OWASP API Security Top 10. Если вы знакомы с семейством OWASP Top 10, то вы заметите сходства, их основная цель - улучшение читаемости и повышение частоты использования настоящего документа. В противном случае посетите страницу [OWASP API Security Project wiki][1] перед погружением в наиболее критичные риски безопасности API.

API играют важную роль в архитектуре современных приложений. Поскольку информированность в сфере безопасности и инновации движутся с разной скоростью, важно сфокусироваться на общих недостатках безопасности API.

Основная цель OWASP API Security Top 10 - предоставить информацию людям, вовлечённым в разработку и поддержание API, например, разработчикам, дизайнерам, архитекторам, менеджерам или целым организациям.

В секции [Методология и Данные][2] вы можете более подробно ознакомиться с тем, как была создана текущая версия. В будущих версиях мы хотим вовлечь индустрию безопасности путём публичного сбора данных. А сейчас мы призываем всех внести свой вклад вопросами, комментариями и идеями в нашем [GitHub репозитории][3] или [Списке рассылки][4].

[1]: https://www.owasp.org/index.php/OWASP_API_Security_Project
[2]: ./0xd0-about-data.md
[3]: https://github.com/OWASP/API-Security
[4]: https://groups.google.com/a/owasp.org/forum/#!forum/api-security-project
OWASP API Security Top 10: 0xd1 acknowledgments

# Благодарность

## Благодарность участникам

Мы хотели бы поблагодарить всех участников, кто публично участвовал в проекте на GitHub или другими способами:

* 007divyachawla
* Abid Khan
* Adam Fisher
* anotherik
* bkimminich
* caseysoftware
* Chris Westphal
* dsopas
* DSotnikov
* emilva
* ErezYalon
* flascelles
* Guillaume Benats
* IgorSasovets
* Inonshk
* JonnySchnittger
* jmanico
* jmdx
* Keith Casey
* kozmic
* LauraRosePorter
* Matthieu Estrade
* nathanawmk
* PauloASilva
* pentagramz
* philippederyck
* pleothaud
* r00ter
* Raj kumar
* Sagar Popat
* Stephen Gates
* thomaskonrad
* xycloops123
OWASP API Security Top 10: 0x04 release notes

# Анонс выпуска

Это первая версия OWASP API Security Top 10, которую мы планируем обновлять каждые три-четыре года.

В будущих версиях, в отличие от этой, мы планируем публичный сбор данных, вовлекая индустрию безопасности в эту активность. В секции [Методология и Данные][1] вы можете найти подробности о том, как эта версия была создана. Для дополнительной информации о рисках безопасности обратитесь к секции [Риски безопасности API][2].

Необходимо понимать, что за последние несколько лет архитектура приложений значительно изменилась. В настоящий момент API играют очень важную роль в новой архитектуре микросервисов, одностраничных приложений (SPA), мобильных приложений, интернете вещей и так далее.

OWASP API Security Top 10 - попытка повысить информированность о проблемах безопасности современных API. Он был возможен благодаря труду волонтёров, перечисленных в секции [Благодарность][3]. Спасибо вам!

[1]: ./0xd0-about-data.md
[2]: ./0x10-api-security-risks.md
[3]: ./0xd1-acknowledgments.md
OWASP API Security Top 10: 0x10 api security risks

# Риски безопасности API

Для анализа рисков была использована [Методология оценки рисков OWASP][1].

Терминология, относящаяся к оценкам риска, приведена в таблице ниже.

| Источники угроз | Сложность эксплуатации | Распространенность | Сложность обнаружения | Технические последствия | Последствия для бизнеса |
| :-: | :-: | :-: | :-: | :-: | :-: |
| Зависит от API | Просто: **3** | Широкая **3** | Просто **3** | Значительные **3** | Зависит от бизнеса |
| Зависит от API | Средне: **2** | Обычная **2** | Средне **2** | Средние **2** | Зависит от бизнеса |
| Зависит от API | Сложно: **1** | Редкая **1** | Сложно **1** | Незначительные **1** | Зависит от бизнеса |

**Примечание**: Этот подход не принимает во внимание источник угроз, а также различные технические детали вашего конкретного приложения. Любой из этих факторов может значительно повлиять на общую вероятность обнаружения и эксплуатации злоумышленником конкретной уязвимости. Эта система оценки не принимает во внимание фактические последствия для вашего бизнеса. Вашей организации необходимо решить, какие риски безопасности, создаваемые приложениями и API, она готова принять с учётом её культуры безопасности, индустрии и требований регуляторов. Проведение анализа рисков за вас не является целью OWASP API Security Top 10.

## Ссылки

### OWASP

* [OWASP Risk Rating Methodology][1]
* [Article on Threat/Risk Modeling][2]

### Внешние

* [ISO 31000: Risk Management Std][3]
* [ISO 27001: ISMS][4]
* [NIST Cyber Framework (US)][5]
* [ASD Strategic Mitigations (AU)][6]
* [NIST CVSS 3.0][7]
* [Microsoft Threat Modeling Tool][8]

[1]: https://www.owasp.org/index.php/OWASP_Risk_Rating_Methodology
[2]: https://www.owasp.org/index.php/Threat_Risk_Modeling
[3]: https://www.iso.org/iso-31000-risk-management.html
[4]: https://www.iso.org/isoiec-27001-information-security.html
[5]: https://www.nist.gov/cyberframework
[6]: https://www.asd.gov.au/infosec/mitigationstrategies.htm
[7]: https://nvd.nist.gov/vuln-metrics/cvss/v3-calculator
[8]: https://www.microsoft.com/en-us/download/details.aspx?id=49168