mirror of
https://github.com/projectdiscovery/nuclei.git
synced 2025-12-18 01:15:27 +00:00
fa56800fcc
* feat: move fuzz package to root directory * feat: added support for input providers like openapi,postman,etc * feat: integration of new fuzzing logic in engine * bugfix: use and instead of or * fixed lint errors * go mod tidy * add new reqresp type + bump utils * custom http request parser * use new struct type RequestResponse * introduce unified input/target provider * abstract input formats via new inputprovider * completed input provider refactor * remove duplicated code * add sdk method to load targets * rename component url->path * add new yaml format + remove duplicated code * use gopkg.in/yaml.v3 for parsing * update .gitignore * refactor/move + docs fuzzing in http protocol * fuzz: header + query integration test using fuzzplayground * fix integration test runner in windows * feat add support for filter in http fuzz * rewrite header/query integration test with filter * add replace regex rule * support kv fuzzing + misc updates * add path fuzzing example + misc improvements * fix matchedURL + skip httpx on multi formats * cookie fuzz integration test * add json body + params body tests * feat add multipart/form-data fuzzing support * add all fuzz body integration test * misc bug fixes + minor refactor * add multipart form + body form unit tests * only run fuzzing templates if -fuzz flag is given * refactor/move fuzz playground server to pkg * fix integration test + refactor * add auth types and strategies * add file auth provider * start implementing auth logic in http * add logic in http protocol * static auth implemented for http * default :80,:443 normalization * feat: dynamic auth init * feat: dynamic auth using templates * validate targets count in openapi+swagger * inputformats: add support to accept variables * fix workflow integration test * update lazy cred fetch logic * fix unit test * drop postman support * domain related normalization * update secrets.yaml file format + misc updates * add auth prefetch option * remove old secret files * add fuzzing+auth related sdk options * fix/support multiple mode in kv header fuzzing * rename 'headers' -> 'header' in fuzzing rules * fix deadlock due to merge conflict resolution * misc update * add bool type in parsed value * add openapi validation+override+ new flags * misc updates * remove optional path parameters when unavailable * fix swagger.yaml file * misc updates * update print msg * multiple openapi validation enchancements + appMode * add optional params in required_openapi_vars.yaml file * improve warning/verbose msgs in format * fix skip-format-validation not working * use 'params/parameter' instead of 'variable' in openapi * add retry support for falky tests * fix nuclei loading ignored templates (#4849) * fix tag include logic * fix unit test * remove quoting in extractor output * remove quote in debug code command * feat: issue tracker URLs in JSON + misc fixes (#4855) * feat: issue tracker URLs in JSON + misc fixes * misc changes * feat: status update support for issues * feat: report metadata generation hook support * feat: added CLI summary of tickets created * misc changes * introduce `disable-unsigned-templates` flag (#4820) * introduce `disable-unsigned-templates` flag * minor * skip instead of exit * remove duplicate imports * use stats package + misc enhancements * force display warning + adjust skipped stats in unsigned count * include unsigned skipped templates without -dut flag --------- Co-authored-by: Tarun Koyalwar <tarun@projectdiscovery.io> * Purge cache on global callback set (#4840) * purge cache on global callback set * lint * purging cache * purge cache in runner after loading templates * include internal cache from parsers + add global cache register/purge via config * remove disable cache purge option --------- Co-authored-by: Tarun Koyalwar <tarun@projectdiscovery.io> * misc update * add application/octet-stream support * openapi: support path specific params * misc option + readme update --------- Co-authored-by: Sandeep Singh <sandeep@projectdiscovery.io> Co-authored-by: sandeep <8293321+ehsandeep@users.noreply.github.com> Co-authored-by: Tarun Koyalwar <tarun@projectdiscovery.io> Co-authored-by: Tarun Koyalwar <45962551+tarunKoyalwar@users.noreply.github.com> Co-authored-by: Dogan Can Bakir <65292895+dogancanbakir@users.noreply.github.com> Co-authored-by: Mzack9999 <mzack9999@protonmail.com>
582 lines
17 KiB
YAML
582 lines
17 KiB
YAML
openapi: 3.1.0
|
|
info:
|
|
title: VAmPI
|
|
description: OpenAPI v3 specs for VAmPI
|
|
version: '0.1'
|
|
servers:
|
|
- url: http://hackthebox:5000
|
|
components: {}
|
|
paths:
|
|
/createdb:
|
|
get:
|
|
tags:
|
|
- db-init
|
|
summary: Creates and populates the database with dummy data
|
|
description: Creates and populates the database with dummy data
|
|
operationId: api_views.main.populate_db
|
|
responses:
|
|
'200':
|
|
description: Creates and populates the database with dummy data
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
message:
|
|
type: string
|
|
example: 'Database populated.'
|
|
/:
|
|
get:
|
|
tags:
|
|
- home
|
|
summary: VAmPI home
|
|
description: >-
|
|
VAmPI is a vulnerable on purpose API. It was created in order to
|
|
evaluate the efficiency of third party tools in identifying
|
|
vulnerabilities in APIs but it can also be used in learning/teaching
|
|
purposes.
|
|
operationId: api_views.main.basic
|
|
responses:
|
|
'200':
|
|
description: Home - Help
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
message:
|
|
type: string
|
|
example: 'VAmPI the Vulnerable API'
|
|
help:
|
|
type: string
|
|
example: 'VAmPI is a vulnerable on purpose API. It was created in order to evaluate the efficiency of third party tools in identifying vulnerabilities in APIs but it can also be used in learning/teaching purposes.'
|
|
vulnerable:
|
|
type: number
|
|
example: 1
|
|
/users/v1:
|
|
get:
|
|
tags:
|
|
- users
|
|
summary: Retrieves all users
|
|
description: Displays all users with basic information
|
|
operationId: api_views.users.get_all_users
|
|
responses:
|
|
'200':
|
|
description: See basic info about all users
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: object
|
|
properties:
|
|
email:
|
|
type: string
|
|
example: 'mail1@mail.com'
|
|
username:
|
|
type: string
|
|
example: 'name1'
|
|
/users/v1/_debug:
|
|
get:
|
|
tags:
|
|
- users
|
|
summary: Retrieves all details for all users
|
|
description: Displays all details for all users
|
|
operationId: api_views.users.debug
|
|
responses:
|
|
'200':
|
|
description: See all details of the users
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: object
|
|
properties:
|
|
admin:
|
|
type: boolean
|
|
example: false
|
|
email:
|
|
type: string
|
|
example: 'mail1@mail.com'
|
|
password:
|
|
type: string
|
|
example: 'pass1'
|
|
username:
|
|
type: string
|
|
example: 'name1'
|
|
/users/v1/register:
|
|
post:
|
|
tags:
|
|
- users
|
|
summary: Register new user
|
|
description: Register new user
|
|
operationId: api_views.users.register_user
|
|
requestBody:
|
|
description: Username of the user
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
username:
|
|
type: string
|
|
example: 'John.Doe'
|
|
password:
|
|
type: string
|
|
example: 'password123'
|
|
email:
|
|
type: string
|
|
example: 'user@tempmail.com'
|
|
required: true
|
|
responses:
|
|
'200':
|
|
description: Sucessfully created user
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
message:
|
|
type: string
|
|
example: 'Successfully registered. Login to receive an auth token.'
|
|
status:
|
|
type: string
|
|
enum: ['success', 'fail']
|
|
example: 'success'
|
|
'400':
|
|
description: Invalid request
|
|
content: {}
|
|
/users/v1/login:
|
|
post:
|
|
tags:
|
|
- users
|
|
summary: Login to VAmPI
|
|
description: Login to VAmPI
|
|
operationId: api_views.users.login_user
|
|
requestBody:
|
|
description: Username of the user
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
username:
|
|
type: string
|
|
example: 'John.Doe'
|
|
password:
|
|
type: string
|
|
example: 'password123'
|
|
required: true
|
|
responses:
|
|
'200':
|
|
description: Sucessfully logged in user
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
auth_token:
|
|
type: string
|
|
example: 'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE2NzAxNjA2MTcsImlhdCI6MTY3MDE2MDU1Nywic3ViIjoiSm9obi5Eb2UifQ.n17N4AxTbL4_z65-NR46meoytauPDjImUxrLiUMSTQw'
|
|
message:
|
|
type: string
|
|
example: 'Successfully logged in.'
|
|
status:
|
|
type: string
|
|
enum: ['success', 'fail']
|
|
example: 'success'
|
|
'400':
|
|
description: Invalid request
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
type: string
|
|
enum: ['fail']
|
|
example: 'fail'
|
|
message:
|
|
type: string
|
|
example: 'Password is not correct for the given username.'
|
|
/users/v1/{username}:
|
|
get:
|
|
tags:
|
|
- users
|
|
summary: Retrieves user by username
|
|
description: Displays user by username
|
|
operationId: api_views.users.get_by_username
|
|
parameters:
|
|
- name: username
|
|
in: path
|
|
description: retrieve username data
|
|
required: true
|
|
schema:
|
|
type: string
|
|
example: 'John.Doe'
|
|
responses:
|
|
'200':
|
|
description: Successfully display user info
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: object
|
|
properties:
|
|
username:
|
|
type: string
|
|
example: 'John.Doe'
|
|
email:
|
|
type: string
|
|
example: 'user@tempmail.com'
|
|
'404':
|
|
description: User not found
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
type: string
|
|
enum: ['fail']
|
|
example: 'fail'
|
|
message:
|
|
type: string
|
|
example: 'User not found'
|
|
|
|
delete:
|
|
tags:
|
|
- users
|
|
summary: Deletes user by username (Only Admins)
|
|
description: Deletes user by username (Only Admins)
|
|
operationId: api_views.users.delete_user
|
|
parameters:
|
|
- name: username
|
|
in: path
|
|
description: Delete username
|
|
required: true
|
|
schema:
|
|
type: string
|
|
example: 'name1'
|
|
responses:
|
|
'200':
|
|
description: Sucessfully deleted user
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
message:
|
|
type: string
|
|
example: 'User deleted.'
|
|
status:
|
|
type: string
|
|
enum: ['success', 'fail']
|
|
example: 'success'
|
|
'401':
|
|
description: User not authorized
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
type: string
|
|
example: 'fail'
|
|
enum: ['fail']
|
|
message:
|
|
type: string
|
|
example: 'Only Admins may delete users!'
|
|
'404':
|
|
description: User not found
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
type: string
|
|
example: 'fail'
|
|
enum: ['fail']
|
|
message:
|
|
type: string
|
|
example: 'User not found!'
|
|
/users/v1/{username}/email:
|
|
put:
|
|
tags:
|
|
- users
|
|
summary: Update users email
|
|
description: Update a single users email
|
|
operationId: api_views.users.update_email
|
|
parameters:
|
|
- name: username
|
|
in: path
|
|
description: username to update email
|
|
required: true
|
|
schema:
|
|
type: string
|
|
example: 'name1'
|
|
requestBody:
|
|
description: field to update
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
email:
|
|
type: string
|
|
example: 'mail3@mail.com'
|
|
required: true
|
|
responses:
|
|
'204':
|
|
description: Sucessfully updated user email
|
|
content: {}
|
|
'400':
|
|
description: Invalid request
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
type: string
|
|
enum: ['fail']
|
|
example: 'fail'
|
|
message:
|
|
type: string
|
|
example: 'Please Provide a valid email address.'
|
|
'401':
|
|
description: User not authorized
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
type: string
|
|
enum: ['fail']
|
|
example: 'fail'
|
|
message:
|
|
type: string
|
|
example: 'Invalid Token'
|
|
/users/v1/{username}/password:
|
|
put:
|
|
tags:
|
|
- users
|
|
summary: Update users password
|
|
description: Update users password
|
|
operationId: api_views.users.update_password
|
|
parameters:
|
|
- name: username
|
|
in: path
|
|
description: username to update password
|
|
required: true
|
|
schema:
|
|
type: string
|
|
example: 'name1'
|
|
requestBody:
|
|
description: field to update
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
password:
|
|
type: string
|
|
example: 'pass4'
|
|
required: true
|
|
responses:
|
|
'204':
|
|
description: Sucessfully updated users password
|
|
content: {}
|
|
'400':
|
|
description: Invalid request
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
type: string
|
|
enum: ['fail']
|
|
example: 'fail'
|
|
message:
|
|
type: string
|
|
example: 'Malformed Data'
|
|
'401':
|
|
description: User not authorized
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
type: string
|
|
enum: ['fail']
|
|
example: 'fail'
|
|
message:
|
|
type: string
|
|
example: 'Invalid Token'
|
|
/books/v1:
|
|
get:
|
|
tags:
|
|
- books
|
|
summary: Retrieves all books
|
|
description: Retrieves all books
|
|
operationId: api_views.books.get_all_books
|
|
responses:
|
|
'200':
|
|
description: See all books
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
Books:
|
|
type: array
|
|
items:
|
|
type: object
|
|
properties:
|
|
book_title:
|
|
type: string
|
|
user:
|
|
type: string
|
|
example:
|
|
Books:
|
|
- book_title: 'bookTitle77'
|
|
user: 'name1'
|
|
- book_title: 'bookTitle85'
|
|
user: 'name2'
|
|
- book_title: 'bookTitle47'
|
|
user: 'admin'
|
|
post:
|
|
tags:
|
|
- books
|
|
summary: Add new book
|
|
description: Add new book
|
|
operationId: api_views.books.add_new_book
|
|
requestBody:
|
|
description: >-
|
|
Add new book with title and secret content only available to the user
|
|
who added it.
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
book_title:
|
|
type: string
|
|
example: 'book99'
|
|
secret:
|
|
type: string
|
|
example: 'pass1secret'
|
|
required: true
|
|
responses:
|
|
'200':
|
|
description: Sucessfully added a book
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
message:
|
|
type: string
|
|
example: 'Book has been added.'
|
|
status:
|
|
type: string
|
|
enum: ['success', 'fail']
|
|
example: 'success'
|
|
'400':
|
|
description: Invalid request
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
type: string
|
|
enum: ['fail']
|
|
example: 'fail'
|
|
message:
|
|
type: string
|
|
example: 'Book Already exists!'
|
|
'401':
|
|
description: User not authorized
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
type: string
|
|
enum: ['fail']
|
|
example: 'fail'
|
|
message:
|
|
type: string
|
|
example: 'Invalid Token'
|
|
/books/v1/{book_title}:
|
|
get:
|
|
tags:
|
|
- books
|
|
summary: Retrieves book by title along with secret
|
|
description: >-
|
|
Retrieves book by title along with secret. Only the owner may retrieve
|
|
it
|
|
operationId: api_views.books.get_by_title
|
|
parameters:
|
|
- name: book_title
|
|
in: path
|
|
description: retrieve book data
|
|
required: true
|
|
schema:
|
|
type: string
|
|
example: 'bookTitle77'
|
|
responses:
|
|
'200':
|
|
description: Successfully retrieve book info
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: array
|
|
items:
|
|
type: object
|
|
properties:
|
|
book_title:
|
|
type: string
|
|
example: 'bookTitle77'
|
|
owner:
|
|
type: string
|
|
example: 'name1'
|
|
secret:
|
|
type: string
|
|
example: 'secret for bookTitle77'
|
|
'401':
|
|
description: User not authorized
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
type: string
|
|
enum: ['fail']
|
|
example: 'fail'
|
|
message:
|
|
type: string
|
|
example: 'Invalid Token'
|
|
'404':
|
|
description: Book not found
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
status:
|
|
type: string
|
|
enum: ['fail']
|
|
example: 'fail'
|
|
message:
|
|
type: string
|
|
example: 'Book not found!' |