diff --git a/website/docs/security/authentication.md b/website/docs/security/authentication.md index a53d2a666ba7..ddbfe79ab29c 100644 --- a/website/docs/security/authentication.md +++ b/website/docs/security/authentication.md @@ -92,3 +92,14 @@ A client that specify username and password in MongoDB URI as below is authentic docker run --rm -it --network=ferretdb --entrypoint=mongosh \ mongo 'mongodb://user2:pass2@ferretdb/ferretdb?authMechanism=PLAIN' ``` + +## Authentication Handshake + +:::note +Some drivers may still use the legacy `hello` command to complete a handshake. +::: + +If you encounter any issues while authenticating with FerretDB, try setting the Stable API version to V1 on the client as this may prevent legacy commands from being used. +Please refer to your specific driver documentation on how to set this field. + +If this does not resolve your issue please file a bug report [here](https://github.com/FerretDB/FerretDB/issues/new?assignees=ferretdb-bot&labels=code%2Fbug%2Cnot+ready&projects=&template=bug.yml).