Quickstart: Een Azure Redis-cache gebruiken in .NET Framework

In deze quickstart neemt u Azure Cache voor Redis op in een .NET Framework-app voor toegang tot een veilige, toegewezen cache die toegankelijk is vanuit elke toepassing binnen Azure. U gebruikt met name de client StackExchange.Redis met C#-code in een .NET-console-app.

Ga naar de code op GitHub

Kloon de opslagplaats van Azure-Samples/azure-cache-redis-samples op GitHub.

Vereisten

• Azure-abonnement: u kunt een gratis abonnement nemen
• Visual Studio 2019
• .NET Framework 4 of hoger is vereist voor de StackExchange.Redis-client.

Een exemplaar van Azure Managed Redis (preview) maken

1. Als u een exemplaar van Azure Managed Redis (preview) wilt maken, meldt u zich aan bij Azure Portal en selecteert u Een resource maken.

2. Typ op de pagina Nieuw in het zoekvak Azure Cache voor Redis.

3. Configureer op de pagina Nieuwe Redis-cache de instellingen voor de nieuwe cache.

   Instelling	Een waarde kiezen	Beschrijving
   Abonnement	Open de vervolgkeuzelijst en selecteer uw abonnement.	Het abonnement waaronder u dit nieuwe Azure Managed Redis-exemplaar wilt maken.
   Resourcegroep	Open de vervolgkeuzelijst en selecteer een resourcegroep of kies Nieuwe maken en geef een naam voor de nieuwe resourcegroep op.	Naam voor de resourcegroep waarin de cache en andere resources moeten worden gemaakt. Door al uw app-resources in één resourcegroep te plaatsen, kunt u ze eenvoudig beheren of verwijderen.
   DNS-naam	Voer een naam in die uniek is in de regio.	De cachenaam moet een tekenreeks tussen 1 en 63 tekens zijn in combinatie met de regionaam van de cache die alleen cijfers, letters of afbreekstreepjes bevat. (Als de cachenaam minder dan 45 tekens lang is, moet deze in alle momenteel beschikbare regio's werken.) De naam moet beginnen en eindigen met een getal of letter en mag geen opeenvolgende afbreekstreepjes bevatten. De hostnaam van uw cache-exemplaar is\<DNS name\>.\<Azure region\>.redis.azure.net.
   Location	Open de vervolgkeuzelijst en selecteer een locatie.	Azure Managed Redis is beschikbaar in geselecteerde Azure-regio's.
   Cachetype	Vervolgkeuzelijst en selecteer de prestatielaag en cachegrootte.	De laag bepaalt de prestaties van het Redis-exemplaar, terwijl de cachegrootte bepaalt welk geheugen beschikbaar is voor het opslaan van gegevens. Zie De juiste laag kiezen voor hulp bij het kiezen van de juiste prestatielaag

   

4. Selecteer Volgende: Netwerken en selecteer een openbaar of privé-eindpunt.

5. Selecteer Volgende: Geavanceerd.

   Configureer alle Redis-modules die u wilt toevoegen aan het exemplaar.

   Standaard voor een nieuwe beheerde cache:

   • Microsoft Entra-id is ingeschakeld.
   • Verificatie van toegangssleutels is uitgeschakeld om veiligheidsredenen.

   Belangrijk

   Voor optimale beveiliging wordt u aangeraden Microsoft Entra ID met beheerde identiteiten te gebruiken om aanvragen tegen uw cache te autoriseren, indien mogelijk. Autorisatie met behulp van Microsoft Entra ID en beheerde identiteiten biedt superieure beveiliging en gebruiksgemak ten opzichte van autorisatie van gedeelde toegangssleutels. Zie Microsoft Entra ID gebruiken voor cacheverificatie voor meer informatie over het gebruik van beheerde identiteiten met uw cache.

   Stel clusterbeleid in op Enterprise voor een niet-geclusterde cache of op OSS voor een geclusterde cache. Zie Clusterbeleid voor meer informatie over het kiezen van Clusterbeleid.

   

   Als u actieve geo-replicatie gebruikt, moet deze worden geconfigureerd tijdens het maken. Zie Actieve geo-replicatie configureren voor Azure Managed Redis-exemplaren voor meer informatie.

   Belangrijk

   U kunt het clusterbeleid van een Azure Managed Redis-exemplaar (preview) niet wijzigen nadat u het hebt gemaakt. Als u RediSearch gebruikt , is het clusterbeleid voor ondernemingen vereist en NoEviction wordt het enige verwijderingsbeleid ondersteund.

   Belangrijk

   Als u dit cache-exemplaar in een geo-replicatiegroep gebruikt, kan verwijderingsbeleid niet worden gewijzigd nadat het exemplaar is gemaakt. Zorg ervoor dat u het verwijderingsbeleid van uw primaire knooppunten kent voordat u de cache maakt. Zie Vereisten voor actieve geo-replicatie voor meer informatie over actieve geo-replicatie.

   Belangrijk

   U kunt modules niet wijzigen nadat u een cache-exemplaar hebt gemaakt. Modules moeten zijn ingeschakeld op het moment dat u een Azure Cache voor Redis exemplaar maakt. Er is geen optie om de configuratie van een module in te schakelen nadat u een cache hebt gemaakt.

6. Selecteer Volgende: Tags en overslaan.

7. Selecteer Volgende: Beoordelen en maken.

8. Controleer de instellingen en selecteer Maken.

   Het duurt enkele minuten voordat het Redis-exemplaar is gemaakt. U kunt de voortgang controleren op de overzichtspagina van Azure Managed Redis. Als u bij Status Wordt uitgevoerd ziet staan, kunt u de cache gebruiken.

Een instantie van Azure Cache voor Redis maken

1. Meld u aan bij Azure Portal om een cache te maken. Selecteer een resource maken in het portalmenu.

   

2. Voer in het deelvenster Aan de slag Azure Cache voor Redis in de zoekbalk in. Zoek Azure Cache voor Redis in de zoekresultaten en selecteer Vervolgens Maken.

   

3. Configureer in het deelvenster Nieuwe Redis Cache op het tabblad Basis de volgende instellingen voor uw cache:

   Instelling	Actie	Beschrijving
   Abonnement	Selecteer uw Azure-abonnement.	Het abonnement dat moet worden gebruikt om het nieuwe exemplaar van Azure Cache voor Redis te maken.
   Resourcegroep	Selecteer een resourcegroep of selecteer Nieuwe maken en voer een nieuwe resourcegroepnaam in.	Een naam voor de resourcegroep waarin u uw cache en andere resources wilt maken. Door al uw app-resources in één resourcegroep te plaatsen, kunt u ze eenvoudig beheren of verwijderen.
   DNS-naam	Voer een unieke naam in.	De cachenaam moet een tekenreeks van 1 tot 63 tekens zijn die alleen cijfers, letters en afbreekstreepjes bevat. De naam moet beginnen en eindigen met een getal of letter en mag geen opeenvolgende afbreekstreepjes bevatten. De hostnaam van uw cache-exemplaar is\<DNS name>.redis.cache.windows.net.
   Location	Selecteer een locatie.	Een Azure-regio in de buurt van andere services die gebruikmaken van uw cache.
   Cache-SKU	Selecteer een SKU.	De SKU bepaalt de grootte, prestaties en functieparameters die beschikbaar zijn voor de cache. Zie Azure Cache voor Redis overzicht voor meer informatie.
   Cachegrootte	Selecteer een cachegrootte.	Zie Azure Cache voor Redis overzicht voor meer informatie.

4. Selecteer het tabblad Netwerken of selecteer Volgende: Netwerken.

5. Selecteer op het tabblad Netwerken een connectiviteitsmethode die u voor de cache wilt gebruiken.

6. Selecteer het tabblad Geavanceerd of selecteer Volgende: Geavanceerd.

7. Controleer of selecteer in het deelvenster Geavanceerd een verificatiemethode op basis van de volgende informatie:

   

   • Microsoft Entra Authentication is standaard ingeschakeld voor een nieuwe Basic-, Standard- of Premium-cache en toegangssleutelsverificatie is uitgeschakeld.
   • Voor Basic- of Standard-caches kunt u de selectie voor een niet-TLS-poort kiezen.
   • Voor Standard- en Premium-caches kunt u ervoor kiezen om beschikbaarheidszones in te schakelen. U kunt beschikbaarheidszones niet uitschakelen nadat de cache is gemaakt.
   • Voor een Premium-cache configureert u de instellingen voor niet-TLS-poort, clustering, beheerde identiteit en gegevenspersistentie.

   Belangrijk

   Voor optimale beveiliging wordt u aangeraden Microsoft Entra ID met beheerde identiteiten te gebruiken om aanvragen tegen uw cache te autoriseren, indien mogelijk. Autorisatie met behulp van Microsoft Entra ID en beheerde identiteiten biedt superieure beveiliging en gebruiksgemak ten opzichte van autorisatie van gedeelde toegangssleutels. Zie Microsoft Entra ID gebruiken voor cacheverificatie voor meer informatie over het gebruik van beheerde identiteiten met uw cache.

8. (Optioneel) Selecteer het tabblad Tags of selecteer Volgende: Tags.

9. (Optioneel) Voer op het tabblad Tags een tagnaam en -waarde in als u de cacheresource wilt categoriseren.

10. Selecteer de knop Controleren en maken.

    Op het tabblad Controleren en maken valideert Azure uw configuratie automatisch.

11. Nadat het groene bericht Validatie is geslaagd , selecteert u Maken.

Een nieuwe cache-implementatie vindt meer dan enkele minuten plaats. U kunt de voortgang van de implementatie controleren in het deelvenster Azure Cache voor Redis Overzicht. Wanneer de status Wordt uitgevoerd, is de cache gereed voor gebruik.

Microsoft Entra ID-verificatie gebruiken in uw cache

Voor Azure Redis-caches, met uitzondering van Enterprise- en Enterprise Flash-lagen, is Microsoft Entra-verificatie standaard ingeschakeld. Toegangssleutels zijn standaard uitgeschakeld.

Belangrijk

Microsoft raadt het gebruik van Microsoft Entra ID-verificatie aan voor de veiligste verificatie-ervaring in plaats van wachtwoorden of toegangssleutels te gebruiken. De verificatie die in dit gedeelte van het artikel wordt beschreven, maakt gebruik van toegangssleutels, waarvoor een zeer hoge mate van vertrouwen in de toepassing is vereist en risico's met zich meebrengt die niet aanwezig zijn bij het gebruik van Microsoft Entra-id. Gebruik de methode in dit document alleen als Verificatie van Microsoft Entra-id's niet haalbaar is.

1. Selecteer in Azure Portal de cache waar u verificatie op basis van Microsoft Entra-tokens wilt gebruiken.

2. Selecteer Verificatie in het menu Resource.

3. Selecteer Lid selecteren en voer de naam in van een geldige gebruiker. De gebruiker die u invoert, wordt standaard automatisch toegangsbeleid voor gegevenseigenaar toegewezen wanneer u Opslaan selecteert. U kunt ook een beheerde identiteit of service-principal invoeren om verbinding te maken met uw cache-exemplaar.

   

Zie de referentiepagina's voor identiteit voor informatie over het gebruik van Microsoft Entra ID met Azure CLI.

De bibliotheek installeren voor het gebruik van Microsoft Entra ID-verificatie

De bibliotheek Azure.StackExchange.Redis bevat de verificatiemethode Microsoft Entra ID voor het maken van verbinding met Azure Redis-services met behulp van Microsoft Entra ID. Deze is van toepassing op alle Azure Cache voor Redis, Azure Cache voor Redis Enterprise en Azure Managed Redis (preview).

1. Open uw project in Visual Studio

2. Klik met de rechtermuisknop op het project, kies NuGet-pakketten beheren...

3. Zoeken naar Microsoft.Azure.StackExchangeRedis

4. Klik op De knop Installeren om te installeren

5. Alle gevraagde inhoud accepteren om de installatie te voltooien

---

Verbinding maken met de cache met behulp van Microsoft Entra-id

1. De bibliotheken in uw code opnemen

   using Azure.Identity;
   using StackExchange.Redis
   

2. Gebruik de standaardReferenties van Azure om de clientverbinding te verifiëren. Hierdoor kan uw code de aanmeldingsgegevens van de aangemelde gebruiker gebruiken bij lokaal uitvoeren en een door Azure beheerde identiteit wanneer deze wordt uitgevoerd in Azure zonder codewijziging.

var configurationOptions = await ConfigurationOptions.Parse($"{_redisHostName}").ConfigureForAzureWithTokenCredentialAsync(new DefaultAzureCredential());
ConnectionMultiplexer _newConnection = await ConnectionMultiplexer.ConnectAsync(configurationOptions);
IDatabase Database = _newConnection.GetDatabase();

Het bestand app.config bewerken

1. Bewerk het bestand app.config door de volgende inhoud toe te voegen:

   <appSettings>
       <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/>
   </appSettings>
   

2. Vervang door <cache-hostname> de hostnaam van uw cache, zoals deze wordt weergegeven in het menu Resource in Azure Portal.

   Bijvoorbeeld met Azure Managed Redis of de Enterprise-lagen: my-redis.eastus.azure.net:10000

3. Sla het bestand op.

Zie StackExchange.Redis en de code in een GitHub-opslagplaats voor meer informatie.

Het bestand app.config bewerken

1. Bewerk het bestand app.config door de volgende inhoud toe te voegen:

   <appSettings>
       <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/>
   </appSettings>
   

2. Vervang door <cache-hostname> de hostnaam van uw cache, zoals deze wordt weergegeven in het menu Resource in Azure Portal.

   Bijvoorbeeld met Azure Cache voor Redis: my-redis.eastus.azure.net:6380

3. Sla het bestand op.

Zie StackExchange.Redis en de code in een GitHub-opslagplaats voor meer informatie.

De voorbeeldtoepassing uitvoeren

Druk op Ctrl + F5 om de console-app te bouwen en uit te voeren en zo de serialisatie van .NET-objecten te testen.

Resources opschonen

Als u de resources wilt blijven gebruiken die u in dit artikel hebt gemaakt, moet u de resourcegroep behouden.

Als u klaar bent met de resources, kunt u de Azure-resourcegroep verwijderen die u hebt gemaakt om kosten te voorkomen.

Belangrijk

Het verwijderen van een resourcegroep kan niet ongedaan worden gemaakt. Wanneer u een resourcegroep verwijdert, worden alle resources in de groep definitief verwijderd. Zorg ervoor dat u niet per ongeluk de verkeerde resourcegroep of resources verwijdert. Als u de resources in een bestaande resourcegroep hebt gemaakt die resources bevat die u wilt behouden, kunt u elke resource afzonderlijk verwijderen in plaats van de resourcegroep te verwijderen.

Een resourcegroep verwijderen

1. Meld u aan bij Azure Portal en selecteer vervolgens Resourcegroepen.

2. Selecteer de resourcegroep die u wilt verwijderen.

   Als er veel resourcegroepen zijn, gebruikt u het vak Filter voor een veld... en typt u de naam van de resourcegroep die u voor dit artikel hebt gemaakt. Selecteer de resourcegroep in de lijst met resultaten.

   

3. Selecteer Resourcegroep verwijderen.

4. U wordt gevraagd om het verwijderen van de resourcegroep te bevestigen. Typ ter bevestiging de naam van de resourcegroep. Selecteer vervolgens Verwijderen.

   

Na enkele ogenblikken worden de resourcegroep en alle bijbehorende resources verwijderd.

Gerelateerde inhoud

• Verbindingstolerantie
• Ontwikkeling van best practices