DOC-4439 auth command examples

Author: andy-stark-redis

doctests/cmds_cnxmgmt_test.go

@@ -0,0 +1,67 @@
+// EXAMPLE: cmds_cnxmgmt
+// HIDE_START
+package example_commands_test
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/redis/go-redis/v9"
+)
+
+// HIDE_END
+
+func ExampleClient_cmd_auth() {
+	ctx := context.Background()
+
+	rdb := redis.NewClient(&redis.Options{
+		Addr:     "localhost:6379",
+		Password: "", // no password docs
+		DB:       0,  // use default DB
+	})
+	// REMOVE_START
+
+	// REMOVE_END
+	// STEP_START auth1
+	// REMOVE_START
+	rdb.ConfigSet(ctx, "requirepass", "temp_pass")
+	// REMOVE_END
+	authResult1, err := rdb.Conn().Auth(ctx, "temp_pass").Result()
+
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println(authResult1) // >>> OK
+
+	authResult2, err := rdb.Conn().AuthACL(
+		ctx, "default", "temp_pass",
+	).Result()
+
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println(authResult2) // >>> OK
+	// REMOVE_START
+	rdb.ConfigSet(ctx, "require_pass", "")
+	// REMOVE_END
+	// STEP_END
+
+	// STEP_START auth2
+	authResult3, err := rdb.Conn().AuthACL(ctx,
+		"test_user", "strong_password",
+	).Result()
+
+	if err != nil {
+		fmt.Println(err)
+	}
+
+	fmt.Println(authResult3) // >>> OK
+	// STEP_END
+
+	// Output:
+	// OK
+	// OK
+	// WRONGPASS invalid username-password pair or user is disabled.
+}