AWS solutions documentation change
Summary
Enhanced file metadata documentation with security properties like sha256Hash, status lifecycle, and authorization requirements
Security assessment
Added security context around file access authorization and data integrity through hash verification. The status enum helps track secure file lifecycle states, but no evidence of patching a specific security flaw.
Diff
diff --git a/solutions/latest/dea-api/cases-caseid-files-fileid-info.md b/solutions/latest/dea-api/cases-caseid-files-fileid-info.md index efe7469c2..5abd7ba36 100644 --- a//solutions/latest/dea-api/cases-caseid-files-fileid-info.md +++ b//solutions/latest/dea-api/cases-caseid-files-fileid-info.md @@ -5 +5 @@ -URIHTTP methods +URIHTTP methodsSchemasProperties @@ -7 +7,3 @@ URIHTTP methods -# Cases caseId Files fileId Info +# Cases – Case file info + +This endpoint provides a way to retrieve detailed information about a specific file within a case in DEA, facilitating better management and understanding of the file. The API requires authentication and authorization to ensure that only authorized users can retrieve the details of the file. @@ -17,8 +19 @@ URIHTTP methods -Get details for a file within a case - -Path parametersName| Type| Required| Description ----|---|---|--- -`caseId`| String| True| -`fileId`| String| True| File ID to generate audit log for - -### OPTIONS +Get details for a file within a case. @@ -29 +24 @@ Path parametersName| Type| Required| Description -`fileId`| String| True| File ID to generate audit log for +`fileId`| String| True| @@ -33 +28,75 @@ ResponsesStatus code| Response model| Description -`204`| None| 204 response +`200`| `CaseFile`| Success Response + +## Schemas + +### Response bodies + + + { + "fileName": "string", + "filePath": "string", + "caseUlid": "string", + "contentType": "string", + "createdBy": "string", + "fileSizeBytes": number, + "sha256Hash": "string", + "ulid": "string", + "status": enum, + "uploadId": "string", + "isFile": boolean, + "created": "string", + "updated": "string", + "details": "string", + "fileS3Key": "string", + "dataVaultUlid": "string", + "executionId": "string", + "associationCreatedby": "string", + "associationDate": "string", + "dataVaultUploadDate": "string", + "dataVaultName": "string", + "reason": "string" + } + +## Properties + +### CaseFile + +Property| Type| Required| Description +---|---|---|--- +`associationCreatedby`| string| False| +`associationDate`| string| False| +`caseUlid`| string| False| +`contentType`| string| False| +`created`| string| False| +`createdBy`| string| False| +`dataVaultName`| string| False| +`dataVaultUlid`| string| False| +`dataVaultUploadDate`| string| False| +`details`| string| False| +`executionId`| string| False| +`fileName`| string| False| +`filePath`| string| False| +`fileS3Key`| string| False| +`fileSizeBytes`| number| False| +`isFile`| boolean| False| +`reason`| string| False| +`sha256Hash`| string| False| +`status`| CaseFileStatus| False| +`ulid`| string| False| +`updated`| string| False| +`uploadId`| string| False| + +### CaseFileStatus + + * `ACTIVE` + + * `DELETING` + + * `DELETE_FAILED` + + * `DELETED` + + * `PENDING` + + + @@ -41 +110 @@ To use the Amazon Web Services Documentation, Javascript must be enabled. Please -Cases caseId Files fileId Contents +Cases – Case details by caseId @@ -43 +112 @@ Cases caseId Files fileId Contents -Cases caseId Files fileId Restore +Cases – Case owner