Csatlakozás az Azure AI Search szolgáltatáshoz szerepkörök használatával

1. Jelentkezzen be az Azure Portalra.

2. Rendelje hozzá a következő szerepköröket:

   • Tulajdonos (teljes hozzáférés az összes adatsíkhoz és vezérlősík-művelethez, a lekérdezési engedélyek kivételével)
   • Közreműködő (ugyanaz, mint a tulajdonos, kivéve a szerepkörök hozzárendelésére vonatkozó engedélyeket)
   • Olvasó (a metrikák monitorozásához és megtekintéséhez elfogadható)

Amikor a PowerShellt használja a szerepkörök hozzárendeléséhez, hívja meg a New-AzRoleAssignment parancsot, adja meg az Azure-felhasználó vagy csoport nevét és a hozzárendelés hatókörét.

Ez a példa létrehoz egy keresési szolgáltatás hatókörébe tartozó szerepkör-hozzárendelést:

New-AzRoleAssignment -SignInName <email> `
    -RoleDefinitionName "Reader" `
    -Scope  "/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Search/searchServices/<search-service>"

1. Jelentkezzen be az Azure Portalra.

2. Rendelje hozzá a következő szerepköröket:

   • Keresési szolgáltatás közreműködője (indexeken, indexelőken, képességkészleteken és egyéb legfelső szintű objektumokon végzett létrehozási-olvasási-frissítési-törlési műveletek)
   • Keresési indexadatok közreműködője (dokumentumok betöltése és indexelési feladatok futtatása)
   • Keresési index adatolvasója (index lekérdezése)

Amikor a PowerShellt használja a szerepkörök hozzárendeléséhez, hívja meg a New-AzRoleAssignment parancsot, adja meg az Azure-felhasználó vagy csoport nevét és a hozzárendelés hatókörét.

Ez a példa létrehoz egy keresési szolgáltatás hatókörébe tartozó szerepkör-hozzárendelést:

New-AzRoleAssignment -SignInName <email> `
    -RoleDefinitionName "Search Index Data Contributor" `
    -Scope  "/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Search/searchServices/<search-service>"

Ez a példa létrehoz egy szerepkör-hozzárendelést, amely egy adott indexre terjed ki:

New-AzRoleAssignment -SignInName <email> `
    -RoleDefinitionName "Search Index Data Contributor" `
    -Scope  "/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Search/searchServices/<search-service>/indexes/<index-name>"

1. Jelentkezzen be az Azure Portalra.

2. Rendelje hozzá a Keresési index adatolvasó szerepkört.

Amikor a PowerShellt szerepkörök hozzárendelésére használja, hívja meg a New-AzRoleAssignment parancsot, és adja meg az Azure-felhasználó vagy csoport nevét és a hozzárendelés hatókörét.

1. Kérje le az előfizetés azonosítóját, a keresési szolgáltatás erőforráscsoportját és a keresési szolgáltatás nevét.

2. Kérje le az Azure-szolgáltatás objektumazonosítóját, például az Azure OpenAI-t.

    Get-AzADServicePrincipal -SearchString <YOUR AZURE OPENAI RESOURCE NAME>
   

3. Kérje le a szerepkördefiníciót, és tekintse át az engedélyeket, hogy biztosan ez legyen a kívánt szerepkör.

   Get-AzRoleDefinition -Name "Search Index Data Reader"
   

4. Hozza létre a szerepkör-hozzárendelést, és helyettesítse a helyőrzők érvényes értékeit.

   New-AzRoleAssignment -ObjectId YOUR-AZURE-OPENAI-OBJECT-ID -RoleDefinitionName "Search Index Data Reader" -Scope /subscriptions/YOUR-SUBSCRIPTION-ID/resourcegroups/YOUR-RESOURCE-GROUP/providers/Microsoft.Search/searchServices/YOUR-SEARCH-SERVICE-NAME
   

5. Íme egy példa egy adott indexre hatókörrel rendelkező szerepkör-hozzárendelésre:

   New-AzRoleAssignment -ObjectId YOUR-AZURE-OPENAI-OBJECT-ID `
       -RoleDefinitionName "Search Index Data Reader" `
       -Scope /subscriptions/YOUR-SUBSCRIPTION-ID/resourcegroups/YOUR-RESOURCE-GROUP/providers/Microsoft.Search/searchServices/YOUR-SEARCH-SERVICE-NAME/indexes/YOUR-INDEX-NAME
   

1. Jelentkezzen be az Azure Portalra.

2. Lépjen a keresési szolgáltatáshoz.

3. Az Áttekintés lapon válassza az Indexek lapot:

   • A keresési szolgáltatás közreműködői bármilyen objektumot megtekinthetnek és létrehozhatnak, de nem tölthetnek be dokumentumokat, és nem kérdezhetnek le indexet. Az engedélyek ellenőrzéséhez hozzon létre egy keresési indexet.

   • A keresési index adatszolgáltatói betölthetik a dokumentumokat. Az Adatok importálása varázslón kívül nincs dokumentumbetöltési lehetőség az Azure Portalon, de a dokumentumbetöltési engedélyek megerősítéséhez alaphelyzetbe állíthat és futtathat indexelőt .

   • A keresési index adatolvasói lekérdezhetik az indexet. Az engedélyek ellenőrzéséhez használja a Kereséskezelőt. Lekérdezéseket küldhet és megtekintheti az eredményeket, de nem tekintheti meg az indexdefiníciót, és nem hozhat létre egyet.

Ez a megközelítés a Visual Studio Code REST-ügyfélbővítménnyel való használatát feltételezi.

1. Nyisson meg egy parancshéjat az Azure CLI-hez, és jelentkezzen be az Azure-előfizetésbe.

   az login
   

2. Kérje le a bérlőazonosítót és az előfizetés azonosítóját. Az azonosító egy későbbi lépésben változóként lesz használva.

   az account show
   

3. Hozzáférési jogkivonat lekérése.

   az account get-access-token --query accessToken --output tsv
   

4. Illessze be ezeket a változókat egy új szövegfájlba a Visual Studio Code-ban.

   @baseUrl = PASTE-YOUR-SEARCH-SERVICE-URL-HERE
   @index-name = PASTE-YOUR-INDEX-NAME-HERE
   @token = PASTE-YOUR-TOKEN-HERE
   

5. Illessze be, majd küldjön egy kérést, amely a megadott változókat használja. A "Keresési index adatolvasó" szerepkörhöz lekérdezést küldhet. Bármilyen támogatott API-verziót használhat.

   POST https://{{baseUrl}}/indexes/{{index-name}}/docs/search?api-version=2024-07-01 HTTP/1.1
     Content-type: application/json
     Authorization: Bearer {{token}}
   
       {
            "queryType": "simple",
            "search": "motel",
            "filter": "",
            "select": "HotelName,Description,Category,Tags",
            "count": true
        }
   

További információ arról, hogyan szerezhet be jogkivonatot egy adott környezethez: Azure AI-Search szolgáltatás kezelése REST API-kkal és Microsoft Identitásplatform hitelesítési kódtárakkal.

1. Használja az Azure.Search.Documents csomagot.

2. A jogkivonat-hitelesítéshez használja az Azure.Identity for .NET-et . A Microsoft a DefaultAzureCredential() legtöbb forgatókönyvhöz ajánlott.

3. Íme egy példa egy ügyfélkapcsolatra a használatával DefaultAzureCredential().

   // Create a SearchIndexClient to send create/delete index commands
   SearchIndexClient adminClient = new SearchIndexClient(serviceEndpoint, new DefaultAzureCredential());
   
   // Create a SearchClient to load and query documents
   SearchClient srchclient = new SearchClient(serviceEndpoint, indexName, new DefaultAzureCredential());
   

4. Íme egy másik példa az ügyfél titkos hitelesítő adatainak használatára:

   var tokenCredential =  new ClientSecretCredential(aadTenantId, aadClientId, aadSecret);
   SearchClient srchclient = new SearchClient(serviceEndpoint, indexName, tokenCredential);
   

1. Az azure.search.documents (Pythonhoz készült Azure SDK) használata.

2. A Pythonhoz készült Azure.Identity használata jogkivonat-hitelesítéshez.

3. A DefaultAzureCredential parancsot akkor használja, ha a Python-ügyfél kiszolgálóoldali alkalmazást futtat. Engedélyezze az interaktív hitelesítést , ha az alkalmazás böngészőben fut.

4. Példa:

   from azure.search.documents import SearchClient
   from azure.identity import DefaultAzureCredential
   
   credential = DefaultAzureCredential()
   endpoint = "https://<mysearch>.search.windows.net"
   index_name = "myindex"
   client = SearchClient(endpoint=endpoint, index_name=index_name, credential=credential)
   

1. Használja @azure/search-documents (JavaScripthez készült Azure SDK) 11.3-as verzióját.

2. Az Azure.Identity for JavaScript használata jogkivonat-hitelesítéshez.

3. A React használata esetén használja InteractiveBrowserCredential a Microsoft Entra-hitelesítést a kereséshez. A részletekért lásd: Mikor érdemes használni @azure/identity .

1. Azure-search-documents (Java-hoz készült Azure SDK) használata.

2. Az Azure.Identity for Java használata jogkivonat-hitelesítéshez.

3. A Microsoft a DefaultAzureCredential parancsot javasolja az Azure-ban futó alkalmazásokhoz.

Ezek a lépések az Azure-beli egyéni szerepkörök Azure Portal használatával történő létrehozásából vagy frissítéséből származnak. A meglévő szerepkörből való klónozás támogatott a keresési szolgáltatás oldalán.

Ezek a lépések létrehoznak egy egyéni szerepkört, amely kibővíti a keresési lekérdezési jogosultságokat, hogy név szerint listázzák az indexeket. Az indexek listázása általában rendszergazdai függvénynek minősül.

1. Az Azure Portalon keresse meg a keresési szolgáltatást.

2. A bal oldali navigációs panelen válassza a Hozzáférés-vezérlés (IAM) lehetőséget.

3. A műveletsávon válassza a Szerepkörök lehetőséget.

4. Kattintson a jobb gombbal az Index keresése adatolvasóra (vagy egy másik szerepkörre), és válassza a Klónozás lehetőséget az egyéni szerepkör létrehozása varázsló megnyitásához.

5. Az Alapszintű beállítások lapon adja meg az egyéni szerepkör nevét, például a "Search Index Data Explorer" nevet, majd kattintson a Tovább gombra.

6. Az Engedélyek lapon válassza az Engedély hozzáadása lehetőséget.

7. Az Engedélyek hozzáadása lapon keresse meg, majd válassza ki a Microsoft Keresés csempét.

8. Állítsa be az egyéni szerepkör engedélyeit. A lap tetején, az alapértelmezett műveletek kijelölésével:

   • A Microsoft.Search/operations területen válassza az Olvasás: Az összes elérhető művelet listázása lehetőséget.
   • A Microsoft.Search/searchServices/indexek területen válassza az Olvasás : Index olvasása lehetőséget.

9. Ugyanazon a lapon váltson az Adatműveletek elemre , és a Microsoft.Search/searchServices/indexes/documents területen válassza az Olvasás: Dokumentumok olvasása lehetőséget.

   A JSON-definíció a következő példához hasonlóan néz ki:

   {
    "properties": {
        "roleName": "search index data explorer",
        "description": "",
        "assignableScopes": [
            "/subscriptions/0000000000000000000000000000000/resourceGroups/free-search-svc/providers/Microsoft.Search/searchServices/demo-search-svc"
        ],
        "permissions": [
            {
                "actions": [
                    "Microsoft.Search/operations/read",
                    "Microsoft.Search/searchServices/indexes/read"
                ],
                "notActions": [],
                "dataActions": [
                    "Microsoft.Search/searchServices/indexes/documents/read"
                ],
                "notDataActions": []
            }
        ]
      }
    }
   

10. Válassza a Véleményezés + létrehozás lehetőséget a szerepkör létrehozásához. Mostantól hozzárendelhet felhasználókat és csoportokat a szerepkörhöz.

A PowerShell-példa a keresési index adatolvasójának klónozott egyéni szerepkörének JSON-szintaxisát mutatja be, de az összes indexet név szerint listázhatja.

1. Tekintse át az atomi engedélyek listáját, és állapítsa meg, hogy mely engedélyekre van szüksége. Ebben a példában a következőkre lesz szüksége:

   "Microsoft.Search/operations/read",
   "Microsoft.Search/searchServices/read",
   "Microsoft.Search/searchServices/indexes/read"
   

2. Állítson be egy PowerShell-munkamenetet az egyéni szerepkör létrehozásához. Részletes útmutatásért lásd: Azure PowerShell

3. Adja meg a szerepkördefiníciót JSON-dokumentumként. Az alábbi példa az egyéni szerepkörök PowerShell-lel való létrehozásának szintaxisát mutatja be.

{
  "Name": "Search Index Data Explorer",
  "Id": "88888888-8888-8888-8888-888888888888",
  "IsCustom": true,
  "Description": "List all indexes on the service and query them.",
  "Actions": [
      "Microsoft.Search/operations/read",
      "Microsoft.Search/searchServices/read"
  ],
  "NotActions": [],
  "DataActions": [
      "Microsoft.Search/searchServices/indexes/read"
  ],
  "NotDataActions": [],
  "AssignableScopes": [
    "/subscriptions/{subscriptionId1}"
  ]
}

1. Tekintse át az atomi engedélyek listáját, és állapítsa meg, hogy mely engedélyekre van szüksége.

2. A lépésekért tekintse meg az Azure-beli egyéni szerepkörök létrehozását vagy frissítését a REST API használatával.

3. Másolja vagy hozza létre a szerepkört, vagy használja a JSON-t az egyéni szerepkör megadásához (lásd a JSON-szintaxis PowerShell lapját).

1. Tekintse át az atomi engedélyek listáját, és állapítsa meg, hogy mely engedélyekre van szüksége.

2. A lépésekért tekintse meg az Egyéni Azure-szerepkörök létrehozását vagy frissítését az Azure CLI használatával.

3. A JSON-szintaxist a PowerShell lapon találja.