From 6ffac0c4d185d76cee292e907df3ec729cd1585f Mon Sep 17 00:00:00 2001
From: Denis Kirillov <denis@nspcc.ru>
Date: Tue, 14 Jun 2022 12:24:12 +0300
Subject: [PATCH] [#528] Add java sdk client configuration

Signed-off-by: Denis Kirillov <denis@nspcc.ru>
---
 README.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/README.md b/README.md
index 8d7aaebd..36e9680c 100644
--- a/README.md
+++ b/README.md
@@ -54,6 +54,36 @@ $ S3_GW_PEERS_0_ADDRESS=grpcs://192.168.130.72:8080 \
   neofs-s3-gw
 ```
 
+## AWS SDK Compatibility
+
+To match signature of the request you must not include the following headers to `SignedHeaders`:
+* `User-Agent`
+* `X-Amzn-Trace-Id`
+
+### AWS SDK JAVA v1
+Using [aws-sdk-java](https://github.com/aws/aws-sdk-java) you can get the following error:
+```
+Exception in thread "main" com.amazonaws.services.s3.model.AmazonS3Exception: 
+The request signature we calculated does not match the signature you provided. Check your key and signing method.
+```
+
+To solve this problem you should configure client properly:
+```
+RequestHandler2 handler = new RequestHandler2() {
+   @Override
+   public void beforeAttempt(HandlerBeforeAttemptContext context) {
+      context.getRequest().getHeaders().remove("User-Agent");
+      super.beforeAttempt(context);
+   }
+};
+
+AmazonS3 s3Client = AmazonS3ClientBuilder.standard()
+   .withRequestHandlers(handler)
+   .enablePathStyleAccess()
+   // ...
+   .build()
+```
+
 ## Documentation
 
 - [Configuration](./docs/configuration.md)