{"type":"doc","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Postman","type":"text","marks":[{"type":"strong"}]},{"text":" application provides a nice user interface for making REST requests including S3 api requests. It is easier for many users than a command-line tool like curl and unlike curl it can compute the request signature and ","type":"text"},{"text":"Content-MD5","type":"text","marks":[{"type":"code"}]},{"text":" required by the S3 api.","type":"text"}]},{"type":"paragraph","content":[{"text":"Download it for your OS at ","type":"text"},{"text":"https://www.postman.com/downloads/","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.postman.com/downloads/"}}]},{"text":" and install.","type":"text"}]},{"type":"paragraph","content":[{"text":"After opening it press the “","type":"text"},{"text":"plus","type":"text","marks":[{"type":"strong"}]},{"text":"” button to create a new request e.g. to ","type":"text"},{"text":"PUT","type":"text","marks":[{"type":"code"}]},{"text":" an ","type":"text"},{"text":"object-lock","type":"text","marks":[{"type":"code"}]},{"text":" configuration on a bucket in your domain. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Select the HTTP method and enter the url, to the left of the ","type":"text"},{"text":"Send","type":"text","marks":[{"type":"strong"}]},{"text":" button.","type":"text"}]},{"type":"paragraph","content":[{"text":"PUT https://mydomain.example.com/mylocker?object-lock","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Authorization","type":"text","marks":[{"type":"strong"}]},{"text":" tab select ","type":"text"},{"text":"Type","type":"text","marks":[{"type":"strong"}]},{"text":" “","type":"text"},{"text":"AWS Signature","type":"text","marks":[{"type":"strong"}]},{"text":"” and enter your ","type":"text"},{"text":"AccessKey","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"SecretKey","type":"text","marks":[{"type":"strong"}]},{"text":", which you get when you create an S3 token in Content Portal. Under ","type":"text"},{"text":"Advanced","type":"text","marks":[{"type":"strong"}]},{"text":" you must enter “","type":"text"},{"text":"s3","type":"text","marks":[{"type":"strong"}]},{"text":"” (lowercase S3 or you will get a 403 ","type":"text"},{"text":"SignatureDoesNotMatch","type":"text","marks":[{"type":"code"}]},{"text":"!) for the","type":"text"},{"text":" Service Name","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Body","type":"text","marks":[{"type":"strong"}]},{"text":" tab choose ","type":"text"},{"text":"raw","type":"text","marks":[{"type":"strong"}]},{"text":" and choose ","type":"text"},{"text":"XML","type":"text","marks":[{"type":"strong"}]},{"text":" in the ","type":"text"},{"text":"Text","type":"text","marks":[{"type":"strong"}]},{"text":" dropdown. Enter a body like:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n Enabled\n \n \n 1\n COMPLIANCE\n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"To avoid a ","type":"text"},{"text":"400 Bad Request","type":"text","marks":[{"type":"code"}]},{"text":" error:","type":"text"}]},{"type":"codeBlock","content":[{"text":" InvalidRequest\n Missing required header for this request: Content-MD5","type":"text"}]},{"type":"paragraph","content":[{"text":"You must also add the Key ","type":"text"},{"text":"Content-MD5","type":"text","marks":[{"type":"code"}]},{"text":" with the value ","type":"text"},{"text":"{{contentMD5}}","type":"text","marks":[{"type":"code"}]},{"text":" (that is Postman variable syntax) in the ","type":"text"},{"text":"Headers","type":"text","marks":[{"type":"strong"}]},{"text":" tab. With recent Postman 10.21.0 it seems to report contentMD5 is an Unresolved Variable but V4 signatures still work, probably because ","type":"text"},{"text":"X-Amz-Content-Sha256","type":"text","marks":[{"type":"code"}]},{"text":" is used. The Unresolved Variable issue appears to be fixed by creating an account and signing into Postman and upgrading to v10.21.2.","type":"text"}]},{"type":"paragraph","content":[{"text":"Finally you must enter this in the ","type":"text"},{"text":"Pre-request Script","type":"text","marks":[{"type":"strong"}]},{"text":" tab so that ","type":"text"},{"text":"{{contentMD5}}","type":"text","marks":[{"type":"code"}]},{"text":" variable is available:","type":"text"}]},{"type":"codeBlock","content":[{"text":"var md5checksum = CryptoJS.MD5(\"\"+pm.request.body+\"\");\nbase64value = CryptoJS.enc.Base64.stringify(md5checksum);\npostman.setGlobalVariable(\"contentMD5\", base64value);","type":"text"}]},{"type":"paragraph","content":[{"text":"Now when you press ","type":"text"},{"text":"Send","type":"text","marks":[{"type":"strong"}]},{"text":" you should see a ","type":"text"},{"text":"200 OK","type":"text","marks":[{"type":"code"}]},{"text":" response. The empty response ","type":"text"},{"text":"Body","type":"text","marks":[{"type":"strong"}]},{"text":" is fine.","type":"text"}]}],"version":1}

Browser not supported