Oktatóanyag: Engedély metaadatainak indexelése az ADLS Gen2-ből és lekérdezés engedélyszűréssel (előzetes verzió)

Note

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.

Important

Az (előzetes verzióban) megjelölt funkciókra, képességekre vagy tulajdonságokra nem vonatkozik szolgáltatási szintű szerződés, nem ajánlott éles számítási feladatokhoz, és az általános elérhetővé válásuk előtt változhatnak vagy korlátozhatók. Az Azure AI Keresés előzetes verziójú kifejezések az összes előzetes verziós funkcióra vonatkoznak, függetlenül attól, hogy önálló vagy egy általánosan elérhető funkció része.

Ez az oktatóanyag bemutatja Azure Data Lake Storage (ADLS) Gen2 engedély metaadatainak betöltését (előzetes verzió), amelyben egy Azure AI Keresés indexelő hozzáférés-vezérlési listákat (ACL-eket) és szerepköralapú hozzáférés-vezérlési (RBAC) hatókört ad hozzá egy keresési indexhez.

Azt is bemutatja, hogyan strukturálhat olyan lekérdezést, amely tiszteletben tartja a felhasználói hozzáférési engedélyeket. A sikeres lekérdezés eredménye megerősíti az index során történt engedélyátvitelt.

Az ACL-ek indexelésével kapcsolatos további információkért lásd: ADLS Gen2 indexelő használata az engedély metaadatainak betöltéséhez.

Ebben az oktatóanyagban a következőket sajátíthatja el:

  • RBAC-hatókör és ACL-ek konfigurálása adatforráson adlsgen2
  • Engedélyinformációs mezőket tartalmazó Azure AI Keresés-index létrehozása
  • Indexelő létrehozása és futtatása az engedélyadatok adatforrásból származó indexbe való betöltéséhez
  • Keresés az imént létrehozott indexben

A REST-ügyfél használatával fejezze be ezt az oktatóanyagot és a legújabb előzetes REST API-t. Jelenleg nem támogatott az ACL-indexelés a Azure portálon.

Előfeltételek

  • Aktív előfizetéssel rendelkező Azure fiók. Hozzon létre egy fiókot ingyenesen.

  • Microsoft Entra ID hitelesítés és engedélyezés. A szolgáltatásoknak és alkalmazásoknak ugyanabban a bérlőben kell lenniük. A szerepkör-hozzárendelések minden hitelesített kapcsolathoz használhatók. A felhasználóknak és csoportoknak ugyanabban a bérlőben kell lenniük. Rendelkeznie kell a felhasználókkal és csoportokkal, hogy működjenek együtt. A bérlők és a biztonsági tagok létrehozása az oktatóanyag hatókörén kívül esik.

  • ADLS Gen2 hierarchikus névtérrel.

  • Hierarchikus mappastruktúrában lévő fájlok. Ez az oktatóanyag feltételezi a fájl /Oregon/Portland/Data.txtmappaszerkezetének ADLS Gen2 bemutatóját. Ez az oktatóanyag végigvezeti a fájlok és mappák ACL-hozzárendelésén, hogy sikeresen elvégezhesse a gyakorlatot.

  • Azure AI Keresés bármely régióban. A felügyelt identitások támogatásához alapszintű vagy magasabb szint szükséges.

  • Visual Studio Code a REST ügyfélkiterjesztéssel.

Mintaadatok előkészítése

Töltse fel az állami parkok mintaadatait egy ADLS Gen2-tárolóba. A tároló nevének "parkoknak" kell lennie, és két mappával kell rendelkeznie: "Oregon" és "Washington".

Keresési szolgáltatás konfigurációjának ellenőrzése

A keresési szolgáltatást Microsoft Entra ID hitelesítéshez és engedélyezéshez kell konfigurálni. Tekintse át ezt az ellenőrzőlistát, és győződjön meg arról, hogy felkészült.

Személyes azonosító token lekérése helyi teszteléshez

Ez az oktatóanyag egy REST-ügyfelet feltételez egy helyi rendszeren, amely nyilvános internetkapcsolaton keresztül csatlakozik az Azure-hoz.

A következő lépések elvégzése a személyes azonosító token beszerzéséhez és a Visual Studio Code beállításához az Azure-erőforrásokhoz való helyi kapcsolatokhoz.

Engedélyek beállítása az ADLS Gen2-ben

Ajánlott eljárásként a Group használatát részesítse előnyben a készletek közvetlen hozzárendelése helyett.

  1. Adjon olvasási hozzáférést a tárolóhoz a keresési szolgáltatás identitásának. Az indexelő a keresési szolgáltatás identitását használva csatlakozik az Azure Storage-hoz. A keresési szolgáltatásnak Storage Blob Data Reader engedélyekkel kell rendelkeznie az adatok lekérdezéséhez.

  2. Csoportonkénti vagy felhasználói engedélyek megadása a fájlhierarchiában. A fájlhierarchiában azonosítsa az összes Group és User készletet, amely a tárolókhoz, könyvtárakhoz és fájlokhoz van rendelve.

  3. Az ACL-ek kezeléséhez használhatja a Azure portált. A Storage Browserben válassza az Oregon könyvtárat, majd a helyi menüben válassza az ACL kezelése lehetőséget.

  4. Új biztonsági főképviselők hozzáadása felhasználók és csoportok számára.

  5. Távolítsa el a meglévő jogosultságokat a tulajdonosi csoportok, tulajdonosi felhasználók és egyéb jogosultságok esetében. Ezek az alapelvek nem támogatottak az ACL-indexelés során az előnézeti állapotban.

Keresési index létrehozása engedély metaadataihoz

Hozzon létre egy indexet , amely a tartalom és az engedély metaadatainak mezőit tartalmazza.

Mindenképpen használja a latest preview REST API vagy egy olyan előzetes verziójú Azure SDK csomagot, amely egyenértékű funkciókat biztosít. Az engedélyszűrő tulajdonságai csak az előzetes verziójú API-kban érhetők el.

Demó céljából az engedélymező engedélyezve van retrievable , így ellenőrizheti az index értékeit. Éles környezetben le kell tiltania retrievable a bizalmas információk kiszivárgásának elkerülését.

{
  "name" : "my-adlsgen2-acl-index",
  "fields": [
    {
      "name": "name", "type": "Edm.String",
      "searchable": true, "filterable": false, "retrievable": true
    },
    {
      "name": "description", "type": "Edm.String",
      "searchable": true, "filterable": false, "retrievable": true    
    },
    {
      "name": "location", "type": "Edm.String",
      "searchable": true, "filterable": false, "retrievable": true
    },
    {
      "name": "state", "type": "Edm.String",
      "searchable": true, "filterable": false, "retrievable": true
    },
    {
      "name": "AzureSearch_DocumentKey", "type": "Edm.String",
      "searchable": true, "filterable": false, "retrievable": true, "stored": true,
      "key": true
    },
    { 
      "name": "UserIds", "type": "Collection(Edm.String)", 
      "permissionFilter": "userIds", 
      "searchable": true, "filterable": false, "retrievable": true
    },
    { 
      "name": "GroupIds", "type": "Collection(Edm.String)", 
      "permissionFilter": "groupIds", 
      "searchable": true, "filterable": false, "retrievable": true
    },
    { 
      "name": "RbacScope", "type": "Edm.String", 
      "permissionFilter": "rbacScope", 
      "searchable": true, "filterable": false, "retrievable": true
    }
  ],
  "permissionFilterOption": "enabled"
}

Adatforrás létrehozása

Módosítsa az adatforrás konfigurációját az indexelő engedélybetöltésének és az indexelni kívánt engedély metaadatainak típusának megadásához.

Az adatforrásnak szüksége van rá indexerPermissionOptions.

Ebben az oktatóanyagban a hitelesített kapcsolathoz használjon rendszer által hozzárendelt felügyelt identitást.

{
    "name" : "my-adlsgen2-acl-datasource",
    "type": "adlsgen2",
    "indexerPermissionOptions": ["userIds", "groupIds", "rbacScope"],
    "credentials": {
    "connectionString": "ResourceId=/subscriptions/<your subscription ID>/resourceGroups/<your resource group name>/providers/Microsoft.Storage/storageAccounts/<your storage account name>/;"
    },
    "container": {
    "name": "parks",
    "query": null
    }
}

Az indexelő létrehozása és futtatása

Az indexelő konfigurációja az engedélybetöltéshez elsősorban az fieldMappings való szól.

{
  "name" : "my-adlsgen2-acl-indexer",
  "dataSourceName" : "my-adlsgen2-acl-datasource",
  "targetIndexName" : "my-adlsgen2-acl-index",
  "parameters": {
    "batchSize": null,
    "maxFailedItems": 0,
    "maxFailedItemsPerBatch": 0,
    "configuration": {
      "dataToExtract": "contentAndMetadata",
      "parsingMode": "delimitedText",
      "firstLineContainsHeaders": true,
      "delimitedTextDelimiter": ",",
      "delimitedTextHeaders": ""
      },
  "fieldMappings": [
    { "sourceFieldName": "metadata_user_ids", "targetFieldName": "UserIds" },
    { "sourceFieldName": "metadata_group_ids", "targetFieldName": "GroupIds" },
    { "sourceFieldName": "metadata_rbac_scope", "targetFieldName": "RbacScope" }
    ]
  }
}

Az indexelő létrehozása és azonnali futtatása után a fájl tartalma és az engedély metaadatai az indexbe lesznek indexelve.

Lekérdezés futtatása az eredmények ellenőrzéséhez

A dokumentumok betöltése után lekérdezéseket végezhet el rajtuk a Dokumentumok – Keresés (REST) segítségével.

Az URI ki van terjesztve egy lekérdezési bemenetre, amelyet az /docs/search operátor határoz meg. A lekérdezési token a kérés fejlécében van átadva. További információ: Lekérdezési időalapú ACL és RBAC-kényszerítés.

POST  {{endpoint}}/indexes/stateparks/docs/search?api-version=2026-08-01-preview
Authorization: Bearer {{search-token}}
x-ms-query-source-authorization: {{search-token}}
Content-Type: application/json

{
    "search": "*",
    "select": "name,description,location,GroupIds",
    "orderby": "name asc"
}

Kapcsolódó tartalom

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