Estructura inicial funcional con documentación en el README.md de la FastAPI

This commit is contained in:
2026-09-25 11:20:50 -03:00
parent edc71742fa
commit 774e227642
2710 changed files with 1012769 additions and 0 deletions

View File

@@ -0,0 +1,307 @@
# Copyright: (c) 2020, Jordan Borean (@jborean93) <jborean93@gmail.com>
# MIT License (see LICENSE or https://opensource.org/licenses/MIT)
from collections import OrderedDict
from smbprotocol.structure import BytesField, EnumField, FlagField, IntField, Structure
class Commands:
"""
[MS-SMB2] v53.0 2017-09-15
2.2.1.2 SMB2 Packet Header - SYNC Command
The command code of an SMB2 packet, it is used in the packet header.
"""
SMB2_NEGOTIATE = 0x0000
SMB2_SESSION_SETUP = 0x0001
SMB2_LOGOFF = 0x0002
SMB2_TREE_CONNECT = 0x0003
SMB2_TREE_DISCONNECT = 0x0004
SMB2_CREATE = 0x0005
SMB2_CLOSE = 0x0006
SMB2_FLUSH = 0x0007
SMB2_READ = 0x0008
SMB2_WRITE = 0x0009
SMB2_LOCK = 0x000A
SMB2_IOCTL = 0x000B
SMB2_CANCEL = 0x000C
SMB2_ECHO = 0x000D
SMB2_QUERY_DIRECTORY = 0x000E
SMB2_CHANGE_NOTIFY = 0x000F
SMB2_QUERY_INFO = 0x0010
SMB2_SET_INFO = 0x0011
SMB2_OPLOCK_BREAK = 0x0012
class NtStatus:
"""
[MS-ERREF] https://msdn.microsoft.com/en-au/library/cc704588.aspx
2.3.1 NTSTATUS Values
These values are set in the status field of an SMB2Header response. This is
not an exhaustive list but common values that are returned.
"""
STATUS_SUCCESS = 0x00000000
STATUS_UNSUCCESSFUL = 0xC0000001
STATUS_NETWORK_NAME_DELETED = 0xC00000C9
STATUS_PENDING = 0x00000103
STATUS_NOTIFY_CLEANUP = 0x0000010B
STATUS_NOTIFY_ENUM_DIR = 0x0000010C
STATUS_BUFFER_OVERFLOW = 0x80000005
STATUS_NO_MORE_FILES = 0x80000006
STATUS_END_OF_FILE = 0xC0000011
STATUS_INVALID_EA_NAME = 0x80000013
STATUS_EA_LIST_INCONSISTENT = 0x80000014
STATUS_STOPPED_ON_SYMLINK = 0x8000002D
STATUS_INVALID_INFO_CLASS = 0xC0000003
STATUS_INFO_LENGTH_MISMATCH = 0xC0000004
STATUS_INVALID_HANDLE = 0xC0000008
STATUS_INVALID_PARAMETER = 0xC000000D
STATUS_NO_SUCH_FILE = 0xC000000F
STATUS_INVALID_DEVICE_REQUEST = 0xC0000010
STATUS_MORE_PROCESSING_REQUIRED = 0xC0000016
STATUS_ACCESS_DENIED = 0xC0000022
STATUS_BUFFER_TOO_SMALL = 0xC0000023
STATUS_OBJECT_NAME_INVALID = 0xC0000033
STATUS_OBJECT_NAME_NOT_FOUND = 0xC0000034
STATUS_OBJECT_NAME_COLLISION = 0xC0000035
STATUS_OBJECT_PATH_INVALID = 0xC0000039
STATUS_OBJECT_PATH_NOT_FOUND = 0xC000003A
STATUS_OBJECT_PATH_SYNTAX_BAD = 0xC000003B
STATUS_SHARING_VIOLATION = 0xC0000043
STATUS_EAS_NOT_SUPPORTED = 0xC000004F
STATUS_EA_TOO_LARGE = 0xC0000050
STATUS_NONEXISTENT_EA_ENTRY = 0xC0000051
STATUS_NO_EAS_ON_FILE = 0xC0000052
STATUS_EA_CORRUPT_ERROR = 0xC0000053
STATUS_DELETE_PENDING = 0xC0000056
STATUS_PRIVILEGE_NOT_HELD = 0xC0000061
STATUS_WRONG_PASSWORD = 0xC000006A
STATUS_LOGON_FAILURE = 0xC000006D
STATUS_PASSWORD_EXPIRED = 0xC0000071
STATUS_NONE_MAPPED = 0xC0000073
STATUS_INSUFFICIENT_RESOURCES = 0xC000009A
STATUS_PIPE_NOT_AVAILABLE = 0xC00000AC
STATUS_PIPE_BUSY = 0xC00000AE
STATUS_PIPE_DISCONNECTED = 0xC00000B0
STATUS_PIPE_CLOSING = 0xC00000B1
STATUS_IO_TIMEOUT = 0xC00000B5
STATUS_FILE_IS_A_DIRECTORY = 0xC00000BA
STATUS_NOT_SUPPORTED = 0xC00000BB
STATUS_BAD_NETWORK_NAME = 0xC00000CC
STATUS_REQUEST_NOT_ACCEPTED = 0xC00000D0
STATUS_PIPE_EMPTY = 0xC00000D9
STATUS_INTERNAL_ERROR = 0xC00000E5
STATUS_DIRECTORY_NOT_EMPTY = 0xC0000101
STATUS_NOT_A_DIRECTORY = 0xC0000103
STATUS_CANCELLED = 0xC0000120
STATUS_CANNOT_DELETE = 0xC0000121
STATUS_FILE_CLOSED = 0xC0000128
STATUS_PIPE_BROKEN = 0xC000014B
STATUS_FS_DRIVER_REQUIRED = 0xC000019C
STATUS_USER_SESSION_DELETED = 0xC0000203
STATUS_INSUFF_SERVER_RESOURCES = 0xC0000205
STATUS_NOT_FOUND = 0xC0000225
STATUS_PATH_NOT_COVERED = 0xC0000257
STATUS_DFS_UNAVAILABLE = 0xC000026D
STATUS_NOT_A_REPARSE_POINT = 0xC0000275
STATUS_SERVER_UNAVAILABLE = 0xC0000466
STATUS_DISK_FULL = 0xC000007F
class Smb2Flags:
"""
[MS-SMB2] v53.0 2017-09-15
2.2.1.2 SMB2 Packet Header - SYNC Flags
Indicates various processing rules that need to be done on the SMB2 packet.
"""
SMB2_FLAGS_SERVER_TO_REDIR = 0x00000001
SMB2_FLAGS_ASYNC_COMMAND = 0x00000002
SMB2_FLAGS_RELATED_OPERATIONS = 0x00000004
SMB2_FLAGS_SIGNED = 0x00000008
SMB2_FLAGS_PRIORITY_MASK = 0x00000070
SMB2_FLAGS_DFS_OPERATIONS = 0x10000000
SMB2_FLAGS_REPLAY_OPERATIONS = 0x20000000
class SMB2HeaderAsync(Structure):
"""
[MS-SMB2] 2.2.1.1 SMB2 Packer Header - ASYNC
https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-smb2/ea4560b7-90da-4803-82b5-344754b92a79
The SMB2 Packet header for async commands.
"""
def __init__(self):
self.fields = OrderedDict(
[
(
"protocol_id",
BytesField(
size=4,
default=b"\xfeSMB",
),
),
(
"structure_size",
IntField(
size=2,
default=64,
),
),
("credit_charge", IntField(size=2)),
("channel_sequence", IntField(size=2)),
("reserved", IntField(size=2)),
(
"command",
EnumField(
size=2,
enum_type=Commands,
),
),
("credit_request", IntField(size=2)),
(
"flags",
FlagField(
size=4,
flag_type=Smb2Flags,
),
),
("next_command", IntField(size=4)),
("message_id", IntField(size=8)),
("async_id", IntField(size=8)),
("session_id", IntField(size=8)),
(
"signature",
BytesField(
size=16,
default=b"\x00" * 16,
),
),
("data", BytesField()),
]
)
super().__init__()
class SMB2HeaderRequest(Structure):
"""
[MS-SMB2] v53.0 2017-09-15
2.2.1.2 SMB2 Packet Header - SYNC
This is the header definition that contains the ChannelSequence/Reserved
instead of the Status field used for a Packet request.
"""
def __init__(self):
self.fields = OrderedDict(
[
(
"protocol_id",
BytesField(
size=4,
default=b"\xfeSMB",
),
),
(
"structure_size",
IntField(
size=2,
default=64,
),
),
("credit_charge", IntField(size=2)),
("channel_sequence", IntField(size=2)),
("reserved", IntField(size=2)),
("command", EnumField(size=2, enum_type=Commands)),
("credit_request", IntField(size=2)),
(
"flags",
FlagField(
size=4,
flag_type=Smb2Flags,
),
),
("next_command", IntField(size=4)),
("message_id", IntField(size=8)),
("process_id", IntField(size=4)),
("tree_id", IntField(size=4)),
("session_id", IntField(size=8)),
(
"signature",
BytesField(
size=16,
default=b"\x00" * 16,
),
),
("data", BytesField()),
]
)
super().__init__()
class SMB2HeaderResponse(Structure):
"""
[MS-SMB2] v53.0 2017-09-15
2.2.1.2 SMB2 Packet Header - SYNC
The header definition for an SMB Response that contains the Status field
instead of the ChannelSequence/Reserved used for a Packet response.
"""
def __init__(self):
self.fields = OrderedDict(
[
(
"protocol_id",
BytesField(
size=4,
default=b"\xfeSMB",
),
),
(
"structure_size",
IntField(
size=2,
default=64,
),
),
("credit_charge", IntField(size=2)),
("status", EnumField(size=4, enum_type=NtStatus, enum_strict=False)),
(
"command",
EnumField(
size=2,
enum_type=Commands,
enum_strict=False,
),
),
("credit_response", IntField(size=2)),
(
"flags",
FlagField(
size=4,
flag_type=Smb2Flags,
),
),
("next_command", IntField(size=4)),
("message_id", IntField(size=8)),
("reserved", IntField(size=4)),
("tree_id", IntField(size=4)),
("session_id", IntField(size=8)),
(
"signature",
BytesField(
size=16,
default=b"\x00" * 16,
),
),
("data", BytesField()),
]
)
super().__init__()