add additional examples

Author: ndyakov

examples/confidential_identity/main.go

@@ -0,0 +1,45 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	entraid "github.com/redis-developer/go-redis-entraid"
+	"github.com/redis-developer/go-redis-entraid/identity"
+	redis "github.com/redis/go-redis/v9"
+)
+
+func main() {
+	ctx := context.Background()
+
+	// Create a confidential identity credentials provider
+	// This example uses client secret authentication
+	cp, err := entraid.NewConfidentialCredentialsProvider(entraid.ConfidentialCredentialsProviderOptions{
+		ConfidentialIdentityProviderOptions: identity.ConfidentialIdentityProviderOptions{
+			ClientID:        "your-client-id",
+			ClientSecret:    "your-client-secret",
+			CredentialsType: "ClientSecret",
+			Authority: identity.AuthorityConfiguration{
+				AuthorityType: identity.AuthorityTypeMultiTenant,
+				TenantID:      "your-tenant-id",
+			},
+			Scopes: []string{"https://redis.azure.com/.default"},
+		},
+	})
+	if err != nil {
+		panic(fmt.Errorf("failed to create confidential identity credentials provider: %w", err))
+	}
+
+	// Create Redis client with the credentials provider
+	redisClient := redis.NewClient(&redis.Options{
+		Addr:                         "your-redis-host:6379",
+		StreamingCredentialsProvider: cp,
+	})
+
+	// Test the connection
+	ok, err := redisClient.Ping(ctx).Result()
+	if err != nil {
+		panic(fmt.Errorf("failed to ping Redis: %w", err))
+	}
+	fmt.Println("Ping result:", ok)
+}

examples/default_azure_identity/main.go

@@ -0,0 +1,38 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	entraid "github.com/redis-developer/go-redis-entraid"
+	"github.com/redis-developer/go-redis-entraid/identity"
+	redis "github.com/redis/go-redis/v9"
+)
+
+func main() {
+	ctx := context.Background()
+
+	// Create a default azure identity credentials provider
+	// This example uses the default Azure identity chain
+	cp, err := entraid.NewDefaultAzureCredentialsProvider(entraid.DefaultAzureCredentialsProviderOptions{
+		DefaultAzureIdentityProviderOptions: identity.DefaultAzureIdentityProviderOptions{
+			Scopes: []string{"https://redis.azure.com/.default"},
+		},
+	})
+	if err != nil {
+		panic(fmt.Errorf("failed to create default azure identity credentials provider: %w", err))
+	}
+
+	// Create Redis client with the credentials provider
+	redisClient := redis.NewClient(&redis.Options{
+		Addr:                         "your-redis-host:6379",
+		StreamingCredentialsProvider: cp,
+	})
+
+	// Test the connection
+	ok, err := redisClient.Ping(ctx).Result()
+	if err != nil {
+		panic(fmt.Errorf("failed to ping Redis: %w", err))
+	}
+	fmt.Println("Ping result:", ok)
+}

examples/managed_identity/main.go

@@ -0,0 +1,55 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	entraid "github.com/redis-developer/go-redis-entraid"
+	"github.com/redis-developer/go-redis-entraid/identity"
+	redis "github.com/redis/go-redis/v9"
+)
+
+func main() {
+	ctx := context.Background()
+
+	// Example 1: System-assigned managed identity
+	// This is the simplest configuration, as it uses the system-assigned identity
+	// automatically managed by Azure
+	systemAssignedCP, err := entraid.NewManagedIdentityCredentialsProvider(entraid.ManagedIdentityCredentialsProviderOptions{
+		ManagedIdentityProviderOptions: identity.ManagedIdentityProviderOptions{
+			ManagedIdentityType: identity.SystemAssignedIdentity,
+			Scopes:              []string{"https://redis.azure.com/.default"},
+		},
+	})
+	if err != nil {
+		panic(fmt.Errorf("failed to create system-assigned managed identity credentials provider: %w", err))
+	}
+
+	// Example 2: User-assigned managed identity
+	// Uncomment and use this example if you want to use a user-assigned managed identity
+	/*
+		userAssignedCP, err := entraid.NewManagedIdentityCredentialsProvider(entraid.ManagedIdentityCredentialsProviderOptions{
+			ManagedIdentityProviderOptions: identity.ManagedIdentityProviderOptions{
+				ManagedIdentityType:   identity.UserAssignedIdentity,
+				UserAssignedClientID: "your-user-assigned-identity-client-id",
+				Scopes:               []string{"https://redis.azure.com/.default"},
+			},
+		})
+		if err != nil {
+			panic(fmt.Errorf("failed to create user-assigned managed identity credentials provider: %w", err))
+		}
+	*/
+
+	// Create Redis client with the credentials provider
+	redisClient := redis.NewClient(&redis.Options{
+		Addr:                         "your-redis-host:6379",
+		StreamingCredentialsProvider: systemAssignedCP, // Change to userAssignedCP if using user-assigned identity
+	})
+
+	// Test the connection
+	ok, err := redisClient.Ping(ctx).Result()
+	if err != nil {
+		panic(fmt.Errorf("failed to ping Redis: %w", err))
+	}
+	fmt.Println("Ping result:", ok)
+}

go.mod

@@ -9,7 +9,9 @@ require (
 )
 
 require (
+	github.com/cespare/xxhash/v2 v2.3.0 // indirect
 	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect
 	github.com/stretchr/objx v0.5.2 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect

go.sum

@@ -8,8 +8,14 @@ github.com/Azure/azure-sdk-for-go/sdk/internal v1.10.0/go.mod h1:iZDifYGJTIgIIkY
 github.com/AzureAD/microsoft-authentication-extensions-for-go/cache v0.1.1 h1:WJTmL004Abzc5wDB5VtZG2PJk5ndYDgVacGqfirKxjM=
 github.com/AzureAD/microsoft-authentication-library-for-go v1.4.1 h1:8BKxhZZLX/WosEeoCvWysmKUscfa9v8LIPEEU0JjE2o=
 github.com/AzureAD/microsoft-authentication-library-for-go v1.4.1/go.mod h1:wP83P5OoQ5p6ip3ScPr0BAq0BvuPAvacpEuSzyouqAI=
+github.com/bsm/ginkgo/v2 v2.12.0 h1:Ny8MWAHyOepLGlLKYmXG4IEkioBysk6GpaRTLC8zwWs=
+github.com/bsm/gomega v1.27.10 h1:yeMWxP2pV2fG3FgAODIY8EiRE3dy0aeFYt4l7wh6yKA=
+github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
+github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f h1:lO4WD4F/rVNCu3HqELle0jiPLLBs70cWOduZpkS1E78=
+github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f/go.mod h1:cuUVRXasLTGF7a8hSLbxyZXjz+1KgoB3wDUb6vlszIc=
 github.com/golang-jwt/jwt/v5 v5.2.1 h1:OuVbFODueb089Lh128TAcimifWaLhJwVflnrgM17wHk=
 github.com/golang-jwt/jwt/v5 v5.2.1/go.mod h1:pqrtFR0X4osieyHYxtmOUWsAWrfe1Q5UVIyoH402zdk=
 github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=