Integrieren von Azure Cache for Redis in Service Connector

Auf dieser Seite werden unterstützte Authentifizierungsmethoden und Clients sowie Beispielcode gezeigt, den Sie verwenden können, um Azure Cache for Redis mit anderen Clouddiensten mithilfe von Service Connector zu verbinden. Möglicherweise können Sie auch in anderen Programmiersprachen eine Verbindung zu Azure Cache for Redis herstellen, ohne Service Connector zu verwenden. Auf dieser Seite werden auch die Namen und Werte der Standardumgebungsvariablen (oder die Spring Boot-Konfiguration) angezeigt, die Sie erhalten, wenn Sie die Dienstverbindung erstellen.

Unterstützte Computedienste

Mit Service Connector können Sie die folgenden Computedienste mit Azure Cache for Redis verbinden:

• Azure App Service
• Azure Container Apps
• Azure-Funktionen
• Azure Kubernetes Service (AKS)
• Azure Spring Apps

Unterstützte Authentifizierungstypen und Client-Typen

Die folgende Tabelle zeigt, welche Kombinationen von Authentifizierungsmethoden und Clients für die Verbindung Ihres Computediensts mit Azure Cache for Redis mithilfe von Service Connector unterstützt werden. Ein „Ja“ gibt an, dass die Kombination unterstützt wird, während ein „Nein“ angibt, dass sie nicht unterstützt wird.

Clienttyp	Systemseitig zugewiesene verwaltete Identität	Benutzerseitig zugewiesene verwaltete Identität	Geheimnis/Verbindungszeichenfolge	Dienstprinzipal
.NET	No	Nein	Ja	No
Go	No	Nein	Ja	No
Java	No	Nein	Ja	No
Java - Spring Boot	No	Nein	Ja	No
Node.js	No	Nein	Ja	Nein
Python	No	Nein	Ja	Nein
Keine	Nein	Nein	Ja	No

Diese Tabelle gibt an, dass die einzige unterstützte Authentifizierungsmethode für alle Clienttypen die Methode „Geheimnis/Verbindungszeichenfolge“ ist. Andere Authentifizierungsmethoden werden für die Clienttypen nicht unterstützt, um mithilfe von Service Connector eine Verbindung mit Azure Cache for Redis herzustellen.

Namen von Standard-Umgebungsvariablen oder Anwendungseigenschaften und Beispielcode

Verwenden Sie die unten aufgeführten Umgebungsvariablennamen und Anwendungseigenschaften, um Computedienste mit Azure Cache for Redis zu verbinden. Ersetzen Sie den Platzhaltertext <redis-server-name> und <redis-key> in allen Beispielen unten durch Ihren eigenen Redis-Servernamen und Schlüssel. Weitere Informationen zu Benennungskonventionen finden Sie im Artikel Besonderheiten des Dienstconnectors.

Verbindungszeichenfolge

Warnung

Microsoft empfiehlt, immer den sichersten Authentifizierungsflow zu verwenden. Der in diesem Verfahren beschriebene Authentifizierungsflow erfordert ein sehr hohes Maß an Vertrauen in die Anwendung und birgt Risiken, die bei anderen Flows nicht vorhanden sind. Sie sollten diesen Flow nur verwenden, wenn andere sicherere Flows (z. B. verwaltete Identitäten) nicht anwendbar sind.

.NET

Standardname der Umgebungsvariablen	Beschreibung	Beispielswert
AZURE_REDIS_CONNECTIONSTRING	StackExchange. Redis-Verbindungszeichenfolge	<redis-server-name>.redis.cache.windows.net:6380,password=<redis-key>,ssl=True,defaultDatabase=0

Java

Standardname der Umgebungsvariablen	Beschreibung	Beispielswert
AZURE_REDIS_CONNECTIONSTRING	Jedis-Verbindungszeichenfolge	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

SpringBoot

Anwendungseigenschaften	Beschreibung	Beispielswert
spring.redis.host	Redis-Host	<redis-server-name>.redis.cache.windows.net
spring.redis.port	Redis-Port	6380
spring.redis.database	Redis-Datenbank	0
spring.redis.password	Redis-Schlüssel	<redis-key>
spring.redis.ssl	SSL-Einstellungen	true

Python

Standardname der Umgebungsvariablen	Beschreibung	Beispielswert
AZURE_REDIS_CONNECTIONSTRING	redis-py-Verbindungszeichenfolge	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Go

Standardname der Umgebungsvariablen	Beschreibung	Beispielswert
AZURE_REDIS_CONNECTIONSTRING	redis-py-Verbindungszeichenfolge	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

NodeJS

Standardname der Umgebungsvariablen	Beschreibung	Beispielswert
AZURE_REDIS_CONNECTIONSTRING	node-redis-Verbindungszeichenfolge	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Andere

Standardname der Umgebungsvariablen	Beschreibung	Beispielswert
AZURE_REDIS_HOST	Redis-Host	<redis-server-name>.redis.cache.windows.net
AZURE_REDIS_PORT	Redis-Port	6380
AZURE_REDIS_DATABASE	Redis-Datenbank	0
AZURE_REDIS_PASSWORD	Redis-Schlüssel	<redis-key>
AZURE_REDIS_SSL	SSL-Einstellungen	true

Beispielcode

Nutzen Sie die folgenden Schritte und den folgenden Code, um eine Verbindung mit Azure Cache for Redis mithilfe einer Verbindungszeichenfolge herzustellen.

.NET

1. Installieren Sie Abhängigkeiten.

   dotnet add package StackExchange.Redis --version 2.6.122
   

2. Rufen Sie die Verbindungszeichenfolge aus der Umgebungsvariablen ab, die von Service Connector hinzugefügt wurde.

   using StackExchange.Redis;
   var connectionString = Environment.GetEnvironmentVariable("AZURE_REDIS_CONNECTIONSTRING");
   var _redisConnection = await RedisConnection.InitializeAsync(connectionString: connectionString);
   

Java

1. Fügen Sie der Datei pom.xml die folgende Abhängigkeit hinzu:

   <dependency>
     <groupId>redis.clients</groupId>
     <artifactId>jedis</artifactId>
     <version>4.1.0</version>
     <type>jar</type>
     <scope>compile</scope>
   </dependency>
   

2. Rufen Sie die Verbindungszeichenfolge aus der Umgebungsvariablen ab, die von Service Connector hinzugefügt wurde.

   import redis.clients.jedis.DefaultJedisClientConfig;
   import redis.clients.jedis.Jedis;
   import redis.clients.jedis.JedisShardInfo;
   import java.net.URI;
   
   String connectionString = System.getenv("AZURE_REDIS_CONNECTIONSTRING");
   URI uri = new URI(connectionString);
   JedisShardInfo shardInfo = new JedisShardInfo(uri);
   shardInfo.setSsl(true);
   Jedis jedis = new Jedis(shardInfo);
   

SpringBoot

Weitere Informationen zur Einrichtung Ihrer Spring-Anwendung finden Sie unter Verwenden von Azure Cache for Redis in Spring. Die Konfigurationseigenschaften werden Spring-Apps vom Dienstconnector hinzugefügt.

Python

1. Installieren Sie Abhängigkeiten.

   pip install redis
   

2. Rufen Sie die Verbindungszeichenfolge aus der Umgebungsvariablen ab, die von Service Connector hinzugefügt wurde.

   import os
   import redis
   
   url = os.getenv('AZURE_REDIS_CONNECTIONSTRING')
   url_connection = redis.from_url(url)
   url_connection.ping()
   

Go

1. Installieren Sie Abhängigkeiten.

   go get github.com/redis/go-redis/v9
   

2. Rufen Sie die Verbindungszeichenfolge aus der Umgebungsvariablen ab, die von Service Connector hinzugefügt wurde.

   import (
       "context"
       "fmt"
   
       "github.com/redis/go-redis/v9"
   )
   
   connectionString := os.Getenv("AZURE_REDIS_CONNECTIONSTRING")
   opt, err := redis.ParseURL(connectionString)
   if err != nil {
   	panic(err)
   }
   
   client := redis.NewClient(opt)
   

NodeJS

1. Installieren Sie Abhängigkeiten.

   npm install redis
   

2. Rufen Sie die Verbindungszeichenfolge aus der Umgebungsvariablen ab, die von Service Connector hinzugefügt wurde.

   const redis = require("redis");
   
   const connectionString = process.env.AZURE_REDIS_CONNECTIONSTRING;
   const cacheConnection = redis.createClient({
       url: connectionString,
   });
   await cacheConnection.connect();
   

Andere

Für andere Sprachen können Sie die Verbindungsinformationen verwenden, die Service Connector auf die Umgebungsvariablen festlegt, um eine Verbindung mit Azure Cache for Redis herzustellen. Weitere Informationen zu Umgebungsvariablen finden Sie unter Integrieren von Azure App Configuration mit Service Connector.

Nächste Schritte

Befolgen Sie die unten aufgeführten Tutorials, um mehr über Service Connector zu erfahren.

Informationen zu Service Connector-Konzepten