Mihari API (0.0.1)

Download OpenAPI specification:Download

alerts

Operations about alerts

Create an alert

Request Body schema: application/json

ruleId required	string
artifacts required	Array of strings

Responses

Request samples

Payload

Content type

application/json

{"ruleId": "string",
"artifacts": ["string"
]
}

Response samples

201

Content type

application/json

{"id": "string",
"ruleId": "string",
"createdAt": "2019-08-24T14:15:22Z",
"artifacts": [{"id": "string",
"data": "string",
"dataType": "string",
"source": "string",
"tags": ["string"
]
}
],
"tags": [{"name": "string"
}
]
}

Search alerts

query Parameters

page	integer <int32> Default: 1
limit	integer <int32> Default: 10
artifact	string
rule_id	string
tag	string
fromAt	string <date-time>
toAt	string <date-time>

Responses

Response samples

200
404

Content type

application/json

[{"alerts": [{"id": "string",
"ruleId": "string",
"createdAt": "2019-08-24T14:15:22Z",
"artifacts": [{"id": "string",
"data": "string",
"dataType": "string",
"source": "string",
"tags": ["string"
]
}
],
"tags": [{"name": "string"
}
]
}
],
"total": 0,
"currentPage": 0,
"pageSize": 0
}
]

Delete an alert

path Parameters

id

required

integer <int32>

Responses

Response samples

200
404

Content type

application/json

{"message": "string"
}

artifacts

Operations about artifacts

Delete an artifact

path Parameters

id

required

integer <int32>

Responses

Response samples

200
404

Content type

application/json

{"message": "string"
}

Get an artifact

path Parameters

id

required

integer <int32>

Responses

Response samples

200
404

Content type

application/json

{"id": "string",
"data": "string",
"dataType": "string",
"source": "string",
"tags": ["string"
],
"metadata": { },
"autonomousSystem": {"asn": 0
},
"geolocation": {"country": "string",
"countryCode": "string"
},
"whoisRecord": {"domain": "string",
"createdOn": "2019-08-24",
"updatedOn": "2019-08-24",
"expiresOn": "2019-08-24",
"registrar": { },
"contacts": [{ }
]
},
"reverseDnsNames": [{"name": "string"
}
],
"dnsRecords": [{"resource": "string",
"value": "string"
}
],
"cpes": [{"cpe": "string"
}
],
"ports": [{"port": 0
}
]
}

Enrich an artifact

path Parameters

id

required

integer <int32>

Responses

Response samples

200
404

Content type

application/json

{"message": "string"
}

configs

Operations about configs

Get configs

Responses

Response samples

200

Content type

application/json

[{"name": "string",
"type": "string",
"values": ["string"
],
"isConfigured": true
}
]

ip_addresses

Operations about ip_addresses

Get an IP address

path Parameters

ip

required

string

Responses

Response samples

200
404

Content type

application/json

{"ip": "string",
"countryCode": "string",
"hostname": "string",
"loc": "string",
"asn": 0
}

rules

Operations about rules

Delete a rule

path Parameters

id

required

string

Responses

Response samples

200
404

Content type

application/json

{"message": "string"
}

Get a rule

path Parameters

id

required

string

Responses

Response samples

200
404

Content type

application/json

{"id": "string",
"title": "string",
"description": "string",
"yaml": "string",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"tags": [{"name": "string"
}
]
}

Update a rule

Request Body schema: application/json

id required	string
yaml required	string

Responses

Request samples

Payload

Content type

application/json

{"id": "string",
"yaml": "string"
}

Response samples

200

Content type

application/json

{"id": "string",
"title": "string",
"description": "string",
"yaml": "string",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"tags": [{"name": "string"
}
]
}

Create a rule

Request Body schema: application/json

yaml

required

string

Responses

Request samples

Payload

Content type

application/json

{"yaml": "string"
}

Response samples

201

Content type

application/json

{"id": "string",
"title": "string",
"description": "string",
"yaml": "string",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"tags": [{"name": "string"
}
]
}

Search rules

query Parameters

page	integer <int32> Default: 1
limit	integer <int32> Default: 10
title	string
description	string
tag	string
fromAt	string <date-time>
toAt	string <date-time>

Responses

Response samples

200
404

Content type

application/json

[{"rules": [{"id": "string",
"title": "string",
"description": "string",
"yaml": "string",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"tags": [{"name": "string"
}
]
}
],
"total": 0,
"currentPage": 0,
"pageSize": 0
}
]

Run a rule

path Parameters

id

required

string

Responses

Response samples

200

Content type

application/json

{"message": "string"
}

Get rule IDs

Get Rule IDs

Responses

Response samples

200

Content type

application/json

[{"ruleIds": "string"
}
]

Mihari API (0.0.1)

alerts

Create an alert

Request Body schema: application/json

Responses

Request samples

Response samples

Search alerts

query Parameters

Responses

Response samples

Delete an alert

path Parameters

Responses

Response samples

artifacts

Delete an artifact

path Parameters

Responses

Response samples

Get an artifact

path Parameters

Responses

Response samples

Enrich an artifact

path Parameters

Responses

Response samples

configs

Get configs

Responses

Response samples

ip_addresses

Get an IP address

path Parameters

Responses

Response samples

rules

Delete a rule

path Parameters

Responses

Response samples

Get a rule

path Parameters

Responses

Response samples

Update a rule

Request Body schema: application/json

Responses

Request samples

Response samples

Create a rule

Request Body schema: application/json

Responses

Request samples

Response samples

Search rules

query Parameters

Responses

Response samples

Run a rule

path Parameters

Responses

Response samples

Get rule IDs

Responses

Response samples

tags

Delete a tag

path Parameters

Responses

Response samples

Get tags

Responses

Response samples