Rychlý start: Použití Azure Cache for Redis s aplikací v Pythonu

Povolení ověřování Microsoft Entra ID v mezipaměti

V případě existující mezipaměti nejprve zkontrolujte, jestli je povolené ověřování Microsoft Entra. Pokud tomu tak není, povolte ověřování Microsoft Entra provedením následujících kroků. Pro ověřování v aplikacích doporučujeme použít ID Microsoft Entra.

1. Na webu Azure Portal vyberte instanci Azure Cache for Redis, ve které chcete použít ověřování založené na tokenech Microsoft Entra.

2. V nabídce služby v části Nastavení vyberte Ověřování.

3. V podokně Ověřování zkontrolujte, zda je zaškrtnuté políčko Povolit ověřování Microsoft Entra. Pokud ano, můžete přejít k další části.

4. V opačném případě zaškrtněte políčko Povolit ověřování Microsoft Entra. Pak zadejte jméno platného uživatele. Zvolte Uložit. Uživatelské jméno, které zadáte, se automaticky přiřadí zásadám přístupu vlastníka dat.

   Můžete také zadat spravovanou identitu nebo instanční objekt pro připojení k mezipaměti.

   

5. V dialogovém okně se zobrazí dotaz, jestli chcete aktualizovat konfiguraci, a jste informováni, že dokončení aktualizace trvá několik minut. Vyberte Ano.

   Důležité

   Po dokončení operace povolení se uzly v mezipaměti restartují, aby se načetla nová konfigurace. Tuto operaci doporučujeme dokončit během standardního časového období údržby nebo mimo špičku pracovní doby. Proces může trvat až 30 minut.

Informace o použití ID Microsoft Entra s Azure CLI najdete na referenčních stránkách identit.

Instalace knihovny Microsoft Authentication Library

Microsoft Authentication Library (MSAL) získává tokeny zabezpečení z platformy Microsoft Identity Platform pro ověřování uživatelů.

Instalace knihovny MSAL:

1. Nainstalujte MSAL pro Python.

2. Nainstalujte klientskou knihovnu identit Azure v Pythonu. Knihovna používá knihovnu MSAL k zajištění podpory ověřování tokenů.

   Nainstalujte tuto knihovnu pomocí nástroje pip:

pip install azure-identity

Vytvoření skriptu Pythonu pomocí Microsoft Entra ID

1. Vytvořte textový soubor. Uložte soubor jako PythonApplication1.py.

2. V PythonApplication1.py přidejte a upravte následující skript.

   Ve skriptu:

   • Nahraďte <Your Host Name> hodnotou z instance Azure Cache for Redis. Váš název hostitele má formulář <DNS name>.redis.cache.windows.net.
   • Nahraďte <Your Username> hodnotou uživatele Microsoft Entra ID.

   import redis
   from azure.identity import DefaultAzureCredential
   
   scope = "https://redis.azure.com/.default"
   host = "<Your Host Name>"
   port = 6380
   user_name = "<Your Username>"
   
   
   def hello_world():
       cred = DefaultAzureCredential()
       token = cred.get_token(scope)
       r = redis.Redis(host=host,
                       port=port,
                       ssl=True,    # ssl connection is required.
                       username=user_name,
                       password=token.token,
                       decode_responses=True)
       result = r.ping()
       print("Ping returned : " + str(result))
   
       result = r.set("Message", "Hello!, The cache is working with Python!")
       print("SET Message returned : " + str(result))
   
       result = r.get("Message")
       print("GET Message returned : " + result)
   
       result = r.client_list()
       print("CLIENT LIST returned : ")
       for c in result:
           print(f"id : {c['id']}, addr : {c['addr']}")
   
   if __name__ == '__main__':
       hello_world()
   

3. Před spuštěním kódu Pythonu v terminálu povolte terminál tak, aby používal Microsoft Entra ID:

   azd auth login

4. Spusťte soubor PythonApplication1.py pomocí Pythonu. Ověřte, že výstup vypadá podobně jako v tomto příkladu:

   

Vytvoření skriptu Pythonu pomocí opětovného ověření

Přístupový token Microsoft Entra ID má omezenou životnost přibližně 75 minut. Pokud chcete zachovat připojení k mezipaměti, musíte token aktualizovat.

Tento příklad ukazuje, jak aktualizovat token pomocí Pythonu.

1. Vytvořte textový soubor. Uložte soubor jako PythonApplication2.py.

2. V PythonApplication2.py přidejte a upravte následující skript.

   Ve skriptu:

   • Nahraďte <Your Host Name> hodnotou z instance Azure Cache for Redis. Váš název hostitele má formulář <DNS name>.redis.cache.windows.net.
   • Nahraďte <Your Username> hodnotou uživatele Microsoft Entra ID.

   import time
   import logging
   import redis
   from azure.identity import DefaultAzureCredential
   
   scope = "https://redis.azure.com/.default"
   host = "<Your Host Name>"
   port = 6380
   user_name = "<Your Username>"
   
   def re_authentication():
       _LOGGER = logging.getLogger(__name__)
       cred = DefaultAzureCredential()
       token = cred.get_token(scope)
       r = redis.Redis(host=host,
                       port=port,
                       ssl=True,   # ssl connection is required.
                       username=user_name,
                       password=token.token,
                       decode_responses=True)
       max_retry = 3
       for index in range(max_retry):
           try:
               if _need_refreshing(token):
                   _LOGGER.info("Refreshing token...")
                   tmp_token = cred.get_token(scope)
                   if tmp_token:
                       token = tmp_token
                   r.execute_command("AUTH", user_name, token.token)
               result = r.ping()
               print("Ping returned : " + str(result))
   
               result = r.set("Message", "Hello!, The cache is working with Python!")
               print("SET Message returned : " + str(result))
   
               result = r.get("Message")
               print("GET Message returned : " + result)
   
               result = r.client_list()
               print("CLIENT LIST returned : ")
               for c in result:
                   print(f"id : {c['id']}, addr : {c['addr']}")
               break
           except redis.ConnectionError:
               _LOGGER.info("Connection lost. Reconnecting.")
               token = cred.get_token(scope)
               r = redis.Redis(host=host,
                               port=port,
                               ssl=True,   # ssl connection is required.
                               username=user_name,
                               password=token.token,
                               decode_responses=True)
           except Exception:
               _LOGGER.info("Unknown failures.")
               break
   
   
   def _need_refreshing(token, refresh_offset=300):
       return not token or token.expires_on - time.time() < refresh_offset
   
   if __name__ == '__main__':
       re_authentication()
   

3. Spusťte soubor PythonApplication2.py pomocí Pythonu. Ověřte, že výstup vypadá podobně jako v tomto příkladu:

   

   Na rozdíl od předchozího příkladu, pokud platnost tokenu vyprší, kód v tomto příkladu automaticky aktualizuje token.

Získání názvu hostitele, portů a přístupového klíče

Aby se klient mezipaměti připojil k serveru Azure Cache for Redis, potřebuje název hostitele, porty a přístupový klíč mezipaměti. Někteří klienti můžou na tyto položky odkazovat pomocí mírně odlišných názvů. Název hostitele, porty a klíče můžete získat na webu Azure Portal.

• Získání přístupového klíče pro mezipaměť:

  1. Na webu Azure Portal přejděte do mezipaměti.
  2. V nabídce služby v části Nastavení vyberte Ověřování.
  3. V podokně Ověřování vyberte kartu Přístupové klávesy.
  4. Pokud chcete zkopírovat hodnotu přístupového klíče, vyberte v poli klíč ikonu Kopírovat .

  

• Získání názvu hostitele a portů pro mezipaměť:

  1. Na webu Azure Portal přejděte do mezipaměti.
  2. V nabídce služby vyberte Přehled.
  3. V části Základy vyberte u názvu hostitele ikonu Kopírovat a zkopírujte hodnotu názvu hostitele. Hodnota názvu hostitele má formulář <DNS name>.redis.cache.windows.net.
  4. U portů vyberte ikonu Kopírovat a zkopírujte hodnoty portu.

  

Čtení a zápis do mezipaměti na příkazovém řádku

Pokud chcete otestovat mezipaměť, spusťte Python z příkazového řádku.

1. Zadáním příkazu pyiniciujte interpret Pythonu na příkazovém řádku.

2. Upravte a spusťte následující kód.

   V kódu nahraďte <Your Host Name> a <Your Access Key> nahraďte hodnoty z vaší instance Azure Cache for Redis. Váš název hostitele má formulář <DNS name>.redis.cache.windows.net.

   >>> import redis
   >>> r = redis.Redis(host='<Your Host Name>',
           port=6380, db=0, password='<Your Access Key>', ssl=True)
   >>> r.set('foo', 'bar')
   True
   >>> r.get('foo')
   b'bar'
   

Vytvoření skriptu Pythonu pomocí přístupových klíčů

1. Vytvořte nový textový soubor. Uložte soubor jako PythonApplication1.py.

2. V PythonApplication1.py přidejte a upravte následující skript.

   Ve skriptu:

   • Nahraďte <Your Host Name> hodnotou z instance Azure Cache for Redis. Váš název hostitele má formulář <DNS name>.redis.cache.windows.net.
   • Nahraďte <Your Access Key> hodnotou uživatele Microsoft Entra ID.

   import redis
   
   myHostname = "<Your Host Name>"
   myPassword = "<Your Access Key>"
   
   r = redis.Redis(host=myHostname, port=6380,
                         password=myPassword, ssl=True)
   
   result = r.ping()
   print("Ping returned : " + str(result))
   
   result = r.set("Message", "Hello!, The cache is working with Python!")
   print("SET Message returned : " + str(result))
   
   result = r.get("Message")
   print("GET Message returned : " + result)
   
   result = r.client_list()
   print("CLIENT LIST returned : ")
   for c in result:
       print(f"id : {c['id']}, addr : {c['addr']}")
   

3. Spusťte soubor PythonApplication1.py pomocí Pythonu. Ověřte, že se výsledky jako v následujícím příkladu zobrazují jako výstup: