Csatlakozás Azure Storage felügyelt identitással (Azure AI Keresés)

Megjegyzés

Azure AI Keresés a Azure portálon, REST API-kon és Azure SDK-k keresztül érhető el. Emellett a Foundry IQ-t is támogatja, amely a vállalati tartalmakat újrafelhasználható, engedélytudatos tudásbázisokká alakítja át az Microsoft Foundry portálon található ügynökök számára.

Ez a cikk azt ismerteti, hogyan konfigurálhat keresési szolgáltatáskapcsolatot egy Azure Storage-fiókhoz felügyelt identitás használatával ahelyett, hogy hitelesítő adatokat ad meg a kapcsolati karakterlánc.

Használhat rendszer által hozzárendelt felügyelt identitást vagy felhasználó által hozzárendelt felügyelt identitást. A felügyelt identitások Microsoft Entra bejelentkezések, és szerepkör-hozzárendeléseket igényelnek a Azure Storage való hozzáféréshez.

Előfeltételek

Megjegyzés

Ha a tároló hálózati védelem alatt áll, és ugyanabban a régióban van, mint a keresési szolgáltatás, a rendszer által hozzárendelt felügyelt identitást kell használnia, és a következő hálózati lehetőségek egyikét kell használnia: megbízható szolgáltatásként kell csatlakoznia, vagy az erőforráspéldány-szabály használatával kell csatlakoznia.

Az Azure Storage-ban szerepkör hozzárendelése

  1. Jelentkezzen be Azure portálra, és keresse meg a tárfiókját.

  2. Válassza a Hozzáférés-vezérlés (IAM) lehetőséget.

  3. Válassza a Hozzáadás , majd a Szerepkör-hozzárendelés lehetőséget.

  4. A feladatfüggvény-szerepkörök listájában válassza ki a keresési szolgáltatáshoz szükséges szerepköröket:

    Feladat Szerepkör-hozzárendelés
    Blobindexelés indexelő használatával Storage Blob Data Reader hozzáadása
    ADLS Gen2 indexelés indexelő használatával Storage Blob Data Reader hozzáadása
    Táblázatindexelés indexelő használatával Storage Table Data Reader hozzáadása
    Fájlindexelés indexelő használatával Olvasó és adathozzáférés hozzáadása
    Írni a tudástárba Tárblobadat-közreműködő hozzáadása objektum- és fájlvetítésekhez, valamint Olvasó és adathozzáférés táblavetítésekhez.
    Írás a(z) gazdagítási gyorsítótárba (előzetes verzió) Storage Blob-adatszolgáltató és tárolótábla adatszolgáltató hozzáadása
    Hibakeresési munkamenet állapotának mentése Storage Blob Data Contributor hozzáadása

  5. Válassza a Tovább gombot.

  6. Válassza a Felügyelt identitás lehetőséget, majd válassza a Tagok lehetőséget.

  7. Szűrés rendszer által hozzárendelt felügyelt identitások vagy felhasználó által hozzárendelt felügyelt identitások alapján. Látnia kell a keresési szolgáltatáshoz korábban létrehozott felügyelt identitást. Ha nincs ilyenje, olvassa el a Keresés konfigurálása felügyelt identitás használatára című témakört. Ha már beállított egyet, de nem érhető el, várjon pár percet.

  8. Jelölje ki az identitást, és mentse a szerepkör-hozzárendelést.

Adjon meg egy felügyelt identitást egy kapcsolati karakterláncban.

Ha már rendelkezik szerepkör-hozzárendeléssel, beállíthat egy kapcsolatot az Azure Storage-hoz, amely az adott szerepkör alatt működik.

Az indexelők adatforrás-objektumot használnak külső adatforráshoz való kapcsolatokhoz. Ez a szakasz elmagyarázza, hogyan lehet megadni a rendszer által hozzárendelt felügyelt identitást vagy a felhasználó által hozzárendelt felügyelt identitást egy adatforrás kapcsolati sztringen. A felügyelt identitásról szóló cikkben további kapcsolati karakterlánc példákat talál.

Tipp

Az Azure portálon létrehozhat adatforrás-kapcsolatot az Azure Storage-hez, megadhat egy rendszer vagy felhasználó által hozzárendelt felügyelt identitást, majd megtekintheti a JSON-definíciót a kapcsolati sztring kialakításának megtekintéséhez.

Rendszer által hozzárendelt felügyelt identitás

Rendelkeznie kell egy rendszer által hozzárendelt kezelt identitással, és szerepkör-hozzárendeléssel kell rendelkeznie az Azure Storage-on.

A rendszer által hozzárendelt felügyelt identitással létrehozott kapcsolatok esetében az adatforrás-definíció egyetlen módosítása a credentials tulajdonság formátuma.

Adjon meg egy kapcsolati karakterlánc, amely ResourceId tartalmaz, fiókkulcs és jelszó nélkül. Tartalmaznia ResourceId kell a tárfiók előfizetés-azonosítóját, a tárfiók erőforráscsoportját és a tárfiók nevét.

POST https://[service name].search.windows.net/datasources?api-version=2026-04-01

{
    "name" : "blob-datasource",
    "type" : "azureblob",
    "credentials" : { 
        "connectionString" : "ResourceId=/subscriptions/00000000-0000-0000-0000-00000000/resourceGroups/MY-DEMO-RESOURCE-GROUP/providers/Microsoft.Storage/storageAccounts/MY-DEMO-STORAGE-ACCOUNT/;" 
    },
    "container" : { 
        "name" : "my-container", "query" : "<optional-virtual-directory-name>" 
    }
}

Felhasználó által hozzárendelt felügyelt identitás

Rendelkeznie kell egy felhasználó által hozzárendelt felügyelt identitással, amely már össze van kapcsolva a keresési szolgáltatással, és az identitásnak szerepkör-hozzárendeléssel kell rendelkeznie az Azure Storage-hoz.

A felhasználó által hozzárendelt felügyelt identitásokon keresztül létesített kapcsolatok ugyanazokat a hitelesítő adatokat használják, mint a rendszer által hozzárendelt felügyelt identitások, valamint egy további identitástulajdonság, amely a felhasználó által hozzárendelt felügyelt identitások gyűjteményét tartalmazza. Az adatforrás létrehozásakor csak egy felhasználó által hozzárendelt felügyelt identitást kell megadni.

Adjon meg egy kapcsolati karakterlánc, amely ResourceId tartalmaz, fiókkulcs és jelszó nélkül. Tartalmaznia ResourceId kell a tárfiók előfizetés-azonosítóját, a tárfiók erőforráscsoportját és a tárfiók nevét.

identity Adjon meg egy példát az alábbiakban látható szintaxis használatával. Állítsa be userAssignedIdentity a felhasználó által hozzárendelt felügyelt identitást.

POST https://[service name].search.windows.net/datasources?api-version=2026-04-01

{
    "name" : "blob-datasource",
    "type" : "azureblob",
    "credentials" : { 
        "connectionString" : "ResourceId=/subscriptions/00000000-0000-0000-0000-00000000/resourceGroups/MY-DEMO-RESOURCE-GROUP/providers/Microsoft.Storage/storageAccounts/MY-DEMO-STORAGE-ACCOUNT/;" 
    },
    "container" : { 
        "name" : "my-container", "query" : "<optional-virtual-directory-name>" 
    },
    "identity" : { 
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity" : "/subscriptions/00000000-0000-0000-0000-00000000/resourcegroups/MY-DEMO-RESOURCE-GROUP/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MY-DEMO-USER-MANAGED-IDENTITY" 
    }
}

A távoli szolgáltatás kapcsolati adatai és engedélyei futásidőben lesznek érvényesítve az indexelő végrehajtása során. Ha az indexelő sikeres, a kapcsolat szintaxisa és a szerepkör-hozzárendelések érvényesek. További információ: Indexelők, készségek vagy dokumentumok futtatása vagy alaphelyzetbe állítása.

Hálózati védelem alatt lévő adatok elérése tárfiókokban

Azure tárfiókok tűzfalak és virtuális hálózatok használatával tovább védhetők. Ha olyan tárfiókból szeretne tartalmat indexelni, amelyeket tűzfal vagy virtuális hálózat véd, tekintse meg a Az indexelő kapcsolatok megbízható szolgáltatásként történő engedélyezése az Azure Storage-hez című dokumentációt.

Lásd még:

  • Utolsó frissítés időpontja: