{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"2"},"outline":{"value":"false"},"style":{"value":"disc"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"f1d187a3-9eae-4b9b-a66e-f2ad9de1868a"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"fa935fb5-64ca-433c-8ef2-9f083519ffd7"}},{"type":"paragraph","content":[{"text":"Content checksums provide an end-to-end message integrity check for the content (excluding metadata) as it is transmitted to and retrieved from Swarm Storage. Starting from Storage 17.0.1, Swarm supports the following checksum algorithms in addition to ","type":"text"},{"text":"MD5","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://perifery.atlassian.net/wiki/spaces/public/pages/2443822141"}}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SHA1","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SHA256","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CRC32","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CRC32C","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Validating Client-Supplied Checksums","type":"text"}]},{"type":"paragraph","content":[{"text":"During a POST/PUT operation, clients must provide the following headers and query parameters to validate the supplied checksums.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Headers","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Content-Checksum","type":"text","marks":[{"type":"strong"}]},{"text":": The base64-encoded checksum of the payload to validate against the provided checksum with the calculated one. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Content-Checksum-Algorithm","type":"text","marks":[{"type":"strong"}]},{"text":": Specifies the algorithm used for checksum validation.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Query Parameters","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"gencontentchecksum","type":"text","marks":[{"type":"strong"}]},{"text":": Set this query parameter to ","type":"text"},{"text":"yes","type":"text","marks":[{"type":"code"}]},{"text":" to instruct Swarm Storage to generate a checksum for validation against the client-supplied checksum.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example Request","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"curl -i \\\n -H \"Content-Checksum: h/0pKw==\" \\\n -H \"Content-Checksum-Algorithm: crc32\" \\\n -u : \\\n --location-trusted -X POST --post301 \\\n \"http://:/test_bucket1/new4?domain=test&gencontentchecksum=yes\" \\\n --data-binary @a.out","type":"text"}]},{"type":"paragraph","content":[{"text":"Example Response","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"HTTP/1.1 201 Created\nLocation: http://:/test_bucket1/new4?domain=test\nVolume: d3f4a9c2d24e8b3556d2356a2214864a\nLast-Modified: Thu, 20 Mar 2025 08:53:07 GMT\nEntity-MD5: UaKIn+KwsdEJkUWT/jiboA==\nStored-Digest: 51a2889fe2b0b1d109914593fe389ba0\nEtag: \"88c26ea2d5f9fcfb2ef6362c3123f8d8\"\nContent-Checksum: h/0pKw==\nContent-Checksum-Algorithm: crc32\nContent-MD5: Ik4XcdrusTxWlqO/tx7JHg==\nServer: CAStor Cluster/17.0.1\nContent-Length: 46\nContent-Type: text/html\nKeep-Alive: timeout=14400\n\nNew stream created","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Generating Checksums via Swarm Storage","type":"text"}]},{"type":"paragraph","content":[{"text":"Swarm Storage can automatically generate checksums while uploading content. During a POST/PUT operation, clients must provide the following headers and query parameters to generate checksums.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Headers","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Content-Checksum-Algorithm","type":"text","marks":[{"type":"strong"}]},{"text":": Specifies the algorithm to be used for checksum generation.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Query Parameters","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"gencontentchecksum","type":"text","marks":[{"type":"strong"}]},{"text":": Set this query parameter to ","type":"text"},{"text":"yes","type":"text","marks":[{"type":"code"}]},{"text":" to instruct Swarm Storage to generate a checksum.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example Request","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"curl -i \\\n -H \"Content-Checksum-Algorithm: crc32\" \\\n -u : \\\n --location-trusted -X POST --post301 \\\n \"http://:/test_bucket1/new4?domain=test&gencontentchecksum=yes\" \\\n --data-binary @a.out","type":"text"}]},{"type":"paragraph","content":[{"text":"Example Response","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"HTTP/1.1 201 Created\nLocation: http://:/test_bucket1/new4?domain=test\nVolume: d3f4a9c2d24e8b3556d2356a2214864a\nLast-Modified: Thu, 20 Mar 2025 08:48:27 GMT\nEntity-MD5: di3LpGstFBAHUAJBK9gy2Q==\nStored-Digest: 762dcba46b2d1410075002412bd832d9\nEtag: \"06d407b6f0253599679e64a3a1b4352f\"\nContent-Checksum: h/0pKw==\nContent-Checksum-Algorithm: crc32\nContent-MD5: Ik4XcdrusTxWlqO/tx7JHg==\nServer: CAStor Cluster/17.0.1\nContent-Length: 46\nContent-Type: text/html\nKeep-Alive: timeout=14400\n\nNew stream created","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Storing Content Checksum Headers","type":"text"}]},{"type":"paragraph","content":[{"text":"Swarm Storage stores the “Content-Checksum” and “Content-Checksum-Algorithm” headers as part of the object metadata. These headers are returned in all subsequent GET or HEAD requests.","type":"text"}]},{"type":"paragraph","content":[{"text":"For Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"$ curl -i -H \"Content-Checksum-Algorithm: crc32c\" -u : --location-trusted --head --post301 \"http://:/test_bucket\n1/new7?domain=test\"\nHTTP/1.1 200 OK\nCastor-System-CID: b7a3c729e3f032b2ba28c1aa0a456f81\nCastor-System-Cluster: \nCastor-System-Created: Wed, 26 Mar 2025 12:41:21 GMT\nCastor-System-Name: new7\nCastor-System-SegmentOwnerEtag: 429aba8a2c0f8792e9f611427a325ef0\nCastor-System-Version: 1742992881.788\nContent-Type: application/x-www-form-urlencoded\nLast-Modified: Wed, 26 Mar 2025 12:41:21 GMT\nManifest: ec\nContent-Length: 4362751\nEtag: \"429aba8a2c0f8792e9f611427a325ef0\"\nCastor-System-Path: /test/test_bucket1/new7\nCastor-System-Domain: test\nVolume: 704477cf32b7597f2c0d2c794aa2d362\nContent-MD5: InobY1Bl6H9VLWrwQr8N7A==\nContent-Checksum: G6BUiA==\nContent-Checksum-Algorithm: crc32c\nCastor-System-Indexing-DocId: d122990b2d072da0c8684b3b5e7b6729\nDate: Wed, 26 Mar 2025 12:41:47 GMT\nServer: CAStor Cluster/17.0.1\nKeep-Alive: timeout=14400","type":"text"}]}],"version":1}

Browser not supported