docs: credentials/auth FAQ #3745

This will be our new FAQ page for common issues that we can
easily update.

Signed-off-by: Nikolas Komonen <[email protected]>

Author: nkomonen-amazon

README.md

@@ -28,6 +28,10 @@ requests or any positive contribution. See [CONTRIBUTING.md](CONTRIBUTING.md).
     contains full instructions for using the Toolkit.
 -   See other [AWS SDKs and Tools](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html).
 
+## Frequently Asked Questions (FAQ) / Troubleshooting
+
+[Go to page.](./docs/faq-credentials.md)
+
 ## Feedback
 
 We want your feedback!

docs/faq-credentials.md

@@ -0,0 +1,15 @@
+# FAQ / Troubleshooting
+
+### AWS Builder ID "Invalid client provided"
+
+During AWS Builder ID sign in, some users ran in to this error in the browser.
+This is due to a stale state in `~/.aws/sso`.
+
+Issue [aws-toolkit-vscode#3667](https://github.com/aws/aws-toolkit-vscode/issues/3667)
+
+#### Solution
+
+1. Rename the current folder: `mv ~/.aws/sso ~/.aws/sso-OLD`
+2. Attempt to sign in again with AWS Builder ID
+3. If sign is is successful you can remove the old folder: `rm -rf ~/.aws/sso-OLD`
+    1. Or revert the change: `mv ~/.aws/sso-OLD ~/.aws/sso`