2018-04-26 16:08:11 +00:00
|
|
|
require 'swagger/blocks'
|
|
|
|
|
|
|
|
module RootApiDoc
|
|
|
|
include Swagger::Blocks
|
|
|
|
|
2018-05-22 19:57:21 +00:00
|
|
|
ID_DESC = 'The primary key used to identify this object in the database.'
|
|
|
|
CREATED_AT_DESC = 'The date and time this record was added to the database.'
|
|
|
|
UPDATED_AT_DESC = 'The date and time this record was last updated in the database.'
|
|
|
|
WORKSPACE_ID_DESC = 'The ID of the workspace this credential belongs to.'
|
|
|
|
WORKSPACE_POST_DESC = 'The name of the workspace where this record should be created.'
|
|
|
|
WORKSPACE_POST_EXAMPLE = 'default'
|
|
|
|
HOST_EXAMPLE = '127.0.0.1'
|
2018-07-27 18:59:17 +00:00
|
|
|
CODE_DESC = 'The error code that was generated.'
|
|
|
|
CODE_EXAMPLE = 500
|
|
|
|
MESSAGE_DESC = 'A message describing the error that occurred.'
|
|
|
|
MESSAGE_EXAMPLE = 'Undefined method \'empty?\' for nil:NilClass'
|
2018-08-14 16:51:15 +00:00
|
|
|
AUTH_CODE_DESC = 'The authentication error code that was generated.'
|
|
|
|
AUTH_CODE_EXAMPLE = 401
|
|
|
|
AUTH_MESSAGE_DESC = 'A message describing the authentication error that occurred.'
|
2018-08-15 20:26:35 +00:00
|
|
|
|
|
|
|
DEFAULT_RESPONSE_200 = 'Successful operation.'
|
|
|
|
DEFAULT_RESPONSE_401 = 'Authenticate to access this resource.'
|
|
|
|
DEFAULT_RESPONSE_500 = 'An error occurred during the operation. See the message for more details.'
|
2018-05-22 19:57:21 +00:00
|
|
|
|
2018-04-26 16:08:11 +00:00
|
|
|
swagger_root do
|
|
|
|
key :swagger, '2.0'
|
|
|
|
info do
|
|
|
|
key :version, '1.0.0'
|
|
|
|
key :title, 'Metasploit API'
|
2018-05-03 19:20:23 +00:00
|
|
|
key :description, 'An API for interacting with Metasploit\'s data models.'
|
2018-04-26 16:08:11 +00:00
|
|
|
license do
|
|
|
|
key :name, 'BSD-3-clause'
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
key :consumes, ['application/json']
|
|
|
|
key :produces, ['application/json']
|
|
|
|
|
2018-08-14 16:51:15 +00:00
|
|
|
security_definition :api_key do
|
|
|
|
key :type, :apiKey
|
|
|
|
key :name, :Authorization
|
|
|
|
key :in, :header
|
|
|
|
end
|
|
|
|
|
|
|
|
security do
|
|
|
|
key :api_key, []
|
|
|
|
end
|
|
|
|
|
2018-04-30 21:40:07 +00:00
|
|
|
#################################
|
|
|
|
#
|
|
|
|
# Documentation Tags
|
|
|
|
#
|
|
|
|
#################################
|
2018-08-14 16:51:15 +00:00
|
|
|
tag name: 'auth', description: 'Authorization operations.'
|
2018-05-02 21:47:39 +00:00
|
|
|
tag name: 'credential', description: 'Credential operations.'
|
2018-05-02 16:40:56 +00:00
|
|
|
tag name: 'db_export', description: 'Endpoint for generating and retrieving a database backup.'
|
2018-05-03 19:20:23 +00:00
|
|
|
tag name: 'event', description: 'Event operations.'
|
2018-05-02 19:47:17 +00:00
|
|
|
tag name: 'exploit', description: 'Exploit operations.'
|
2018-04-30 21:40:07 +00:00
|
|
|
tag name: 'host', description: 'Host operations.'
|
2018-07-10 19:21:19 +00:00
|
|
|
tag name: 'login', description: 'Login operations.'
|
2018-04-30 21:40:07 +00:00
|
|
|
tag name: 'loot', description: 'Loot operations.'
|
2018-07-18 22:36:31 +00:00
|
|
|
tag name: 'module', description: 'Module search operations.'
|
2018-05-03 22:16:04 +00:00
|
|
|
tag name: 'msf', description: 'Utility operations around Metasploit Framework.'
|
2018-05-02 20:44:07 +00:00
|
|
|
tag name: 'nmap', description: 'Nmap operations.'
|
2018-04-30 21:40:07 +00:00
|
|
|
tag name: 'note', description: 'Note operations.'
|
2018-09-18 22:20:03 +00:00
|
|
|
tag name: 'payload', description: 'Payload operations.'
|
2018-04-30 21:40:07 +00:00
|
|
|
tag name: 'service', description: 'Service operations.'
|
|
|
|
tag name: 'session', description: 'Session operations.'
|
2018-05-03 21:00:56 +00:00
|
|
|
tag name: 'session_event', description: 'Session Event operations.'
|
2018-08-14 18:19:56 +00:00
|
|
|
tag name: 'user', description: 'User operations.'
|
2018-04-30 21:40:07 +00:00
|
|
|
tag name: 'vuln', description: 'Vuln operations.'
|
2018-05-03 21:59:30 +00:00
|
|
|
tag name: 'vuln_attempt', description: 'Vuln Attempt operations.'
|
2018-04-30 21:40:07 +00:00
|
|
|
tag name: 'workspace', description: 'Workspace operations.'
|
|
|
|
|
2018-04-26 16:08:11 +00:00
|
|
|
#################################
|
|
|
|
#
|
|
|
|
# Global parameters
|
|
|
|
#
|
|
|
|
#################################
|
|
|
|
parameter :workspace do
|
|
|
|
key :name, :workspace
|
|
|
|
key :in, :query
|
|
|
|
key :description, 'The workspace from which the data should be gathered from.'
|
|
|
|
key :required, true
|
|
|
|
key :type, :string
|
|
|
|
end
|
|
|
|
|
|
|
|
parameter :update_id do
|
|
|
|
key :name, :id
|
|
|
|
key :in, :path
|
|
|
|
key :description, 'ID of the object to update'
|
|
|
|
key :required, true
|
|
|
|
key :type, :integer
|
|
|
|
key :format, :int32
|
|
|
|
end
|
|
|
|
|
|
|
|
parameter :delete_opts do
|
|
|
|
key :in, :body
|
|
|
|
key :name, :delete_opts
|
|
|
|
key :description, 'The IDs of the objects you want to delete.'
|
|
|
|
key :required, true
|
|
|
|
schema do
|
|
|
|
key :required, [:ids]
|
|
|
|
property :ids do
|
|
|
|
key :type, :array
|
|
|
|
items do
|
|
|
|
key :type, :integer
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
#################################
|
|
|
|
#
|
|
|
|
# Host related parameters
|
|
|
|
#
|
|
|
|
#################################
|
|
|
|
parameter :non_dead do
|
|
|
|
key :name, :non_dead
|
|
|
|
key :in, :query
|
|
|
|
key :description, 'true to return only hosts which are up, false for all hosts.'
|
|
|
|
key :required, false
|
|
|
|
key :type, :boolean
|
|
|
|
end
|
|
|
|
|
|
|
|
parameter :address do
|
|
|
|
key :name, :address
|
|
|
|
key :in, :query
|
|
|
|
key :description, 'Return hosts matching the given IP address.'
|
|
|
|
key :required, false
|
|
|
|
key :type, :string
|
|
|
|
end
|
|
|
|
end
|
2018-07-26 02:46:33 +00:00
|
|
|
|
|
|
|
swagger_schema :ErrorModel do
|
|
|
|
key :required, [:message]
|
|
|
|
property :error do
|
2018-07-27 18:59:17 +00:00
|
|
|
property :code do
|
|
|
|
key :type, :int32
|
|
|
|
key :description, CODE_DESC
|
|
|
|
key :example, CODE_EXAMPLE
|
|
|
|
end
|
2018-07-26 02:46:33 +00:00
|
|
|
property :message do
|
|
|
|
key :type, :string
|
2018-07-27 18:59:17 +00:00
|
|
|
key :description, MESSAGE_DESC
|
|
|
|
key :example, MESSAGE_EXAMPLE
|
2018-07-26 02:46:33 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
2018-08-14 16:51:15 +00:00
|
|
|
|
|
|
|
swagger_schema :AuthErrorModel do
|
|
|
|
key :required, [:message]
|
|
|
|
property :error do
|
|
|
|
property :code do
|
|
|
|
key :type, :int32
|
|
|
|
key :description, AUTH_CODE_DESC
|
|
|
|
key :example, AUTH_CODE_EXAMPLE
|
|
|
|
end
|
|
|
|
property :message do
|
|
|
|
key :type, :string
|
|
|
|
key :description, AUTH_MESSAGE_DESC
|
2018-08-15 20:26:35 +00:00
|
|
|
key :example, DEFAULT_RESPONSE_401
|
2018-08-14 16:51:15 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
end
|