Rolleri kullanarak Azure AI Search'e bağlanma

1. Azure Portal’ında oturum açın.

2. Şu rolleri atayın:

   • Sahip (sorgu izinleri dışında tüm veri düzlemi ve denetim düzlemi işlemlerine tam erişim)
   • Katkıda Bulunan (rol atama izinleri dışında Sahip ile aynıdır)
   • Okuyucu (ölçümleri izlemek ve görüntülemek için kabul edilebilir)

Rol atamak için PowerShell'i kullandığınızda New-AzRoleAssignment çağrısı yaparak Azure kullanıcı veya grup adını ve atamanın kapsamını sağlayın.

Bu örnek, arama hizmeti kapsamında bir rol ataması oluşturur:

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

1. Azure Portal’ında oturum açın.

2. Şu rolleri atayın:

   • Arama Hizmeti Katkıda Bulunanı (dizinler, dizin oluşturucular, beceri kümeleri ve diğer üst düzey nesneler üzerinde oluşturma-okuma-güncelleştirme-silme işlemleri)
   • Dizin Verileri Katkıda Bulunanı Arama (belgeleri yükleme ve dizin oluşturma işlerini çalıştırma)
   • Arama Dizini Veri Okuyucusu (bir dizini sorgulama)

Rol atamak için PowerShell'i kullandığınızda New-AzRoleAssignment çağrısı yaparak Azure kullanıcı veya grup adını ve atamanın kapsamını sağlayın.

Bu örnek, arama hizmeti kapsamında bir rol ataması oluşturur:

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

Bu örnek, kapsamı belirli bir dizine göre belirlenmiş bir rol ataması oluşturur:

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. Azure Portal’ında oturum açın.

2. Arama Dizini Veri Okuyucusu rolünü atayın.

Rol atamak için PowerShell kullanırken New-AzRoleAssignment çağrısı yapın, Azure kullanıcı veya grup adını ve atamanın kapsamını sağlayın.

1. Abonelik kimliğinizi, arama hizmeti kaynak grubunuzu ve arama hizmeti adınızı alın.

2. Azure hizmetinizin nesne tanımlayıcısını (Azure OpenAI gibi) alın.

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

3. Rol tanımını alın ve istediğiniz rolün bu olduğundan emin olmak için izinleri gözden geçirin.

   Get-AzRoleDefinition -Name "Search Index Data Reader"
   

4. Yer tutucular için geçerli değerleri değiştirerek rol atamasını oluşturun.

   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. Aşağıda, kapsamı belirli bir dizine göre belirlenmiş bir rol ataması örneği verilmişti:

   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. Azure Portal’ında oturum açın.

2. Arama hizmetinize gidin.

3. Genel Bakış sayfasında Dizinler sekmesini seçin:

   • Arama Hizmeti Katkıda Bulunanları herhangi bir nesneyi görüntüleyebilir ve oluşturabilir, ancak belgeleri yükleyemez veya bir dizini sorgulayamaz. İzinleri doğrulamak için bir arama dizini oluşturun.

   • Arama Dizini Veri Katkıda Bulunanları belgeleri yükleyebilir. Azure portalında Verileri içeri aktarma sihirbazının dışında belge yükleme seçeneği yoktur, ancak belge yükleme izinlerini onaylamak için bir dizin oluşturucuyu sıfırlayabilir ve çalıştırabilirsiniz.

   • Arama Dizini Veri Okuyucuları dizini sorgulayabilir. İzinleri doğrulamak için Arama gezgini'ni kullanın. Sorgu gönderebilmeniz ve sonuçları görüntüleyebilmeniz gerekir, ancak dizin tanımını görüntüleyememeniz veya oluşturmamanız gerekir.

Bu yaklaşım, REST istemci uzantısına sahip Visual Studio Code'un olduğunu varsayar.

1. Azure CLI için bir komut kabuğu açın ve Azure aboneliğinizde oturum açın.

   az login
   

2. Kiracı kimliğinizi ve abonelik kimliğinizi alın. Kimlik, gelecekteki bir adımda değişken olarak kullanılır.

   az account show
   

3. Erişim belirteci alma.

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

4. Bu değişkenleri Visual Studio Code'da yeni bir metin dosyasına yapıştırın.

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

5. Yapıştırın ve belirttiğiniz değişkenleri kullanan bir istek gönderin. "Arama Dizini Veri Okuyucusu" rolü için bir sorgu gönderebilirsiniz. Desteklenen herhangi bir API sürümünü kullanabilirsiniz.

   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
        }
   

Belirli bir ortam için belirteç alma hakkında daha fazla bilgi için bkz. REST API'leri ve Microsoft kimlik platformu kimlik doğrulama kitaplıkları ile Azure AI Arama hizmeti yönetme.

1. Azure.Search.Documents paketini kullanın.

2. Belirteç kimlik doğrulaması için .NET için Azure.Identity kullanın. Microsoft çoğu DefaultAzureCredential() senaryo için önerir.

3. Aşağıda kullanan bir istemci bağlantısı örneği verilmişti 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. burada gizli anahtar kimlik bilgilerini kullanmanın başka bir örneği verilmişti:

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

1. azure.search.documents (Python için Azure SDK) kullanın.

2. Belirteç kimlik doğrulaması için Python için Azure.Identity kullanın.

3. Python istemcisi sunucu tarafı yürüten bir uygulamaysa DefaultAzureCredential kullanın. Uygulama bir tarayıcıda çalışıyorsa etkileşimli kimlik doğrulamasını etkinleştirin.

4. Bir örnek aşağıda verilmiştir:

   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. @azure/search-documents (JavaScript için Azure SDK), sürüm 11.3 kullanın.

2. Belirteç kimlik doğrulaması için JavaScript için Azure.Identity kullanın.

3. React kullanıyorsanız Arama InteractiveBrowserCredential için Microsoft Entra kimlik doğrulaması kullanın. Ayrıntılar için bkz . Ne zaman kullanılır @azure/identity ?

1. azure-search-documents (Java için Azure SDK) kullanın.

2. Belirteç kimlik doğrulaması için Java için Azure.Identity kullanın.

3. Microsoft, Azure'da çalışan uygulamalar için DefaultAzureCredential'ı önerir.

Bu adımlar, Azure portalını kullanarak Azure özel rollerini oluşturma veya güncelleştirme kaynaklarından türetilir. Mevcut bir rolden kopyalama, arama hizmeti sayfasında desteklenir.

Bu adımlar, dizinleri ada göre listelemek için arama sorgusu haklarını genişleten özel bir rol oluşturur. Dizinleri listeleme genellikle bir yönetici işlevi olarak kabul edilir.

1. Azure portalında arama hizmetinize gidin.

2. Sol gezinti bölmesinde Erişim Denetimi (IAM) öğesini seçin.

3. Eylem çubuğunda Roller'i seçin.

4. Dizin Veri Okuyucusu'na (veya başka bir role) sağ tıklayın ve Özel rol oluşturma sihirbazını açmak için Kopyala'yı seçin.

5. Temel Bilgiler sekmesinde, özel rol için "Arama Dizini Veri Gezgini" gibi bir ad sağlayın ve İleri'yi seçin.

6. İzinler sekmesinde İzin ekle'yi seçin.

7. İzin ekle sekmesinde Microsoft Arama kutucuğunu arayın ve seçin.

8. Özel rolünüz için izinleri ayarlayın. Sayfanın üst kısmında, varsayılan Eylemler seçimini kullanarak:

   • Microsoft.Search/operations altında Okuma: Kullanılabilir tüm işlemleri listele'yi seçin.
   • Microsoft.Search/searchServices/indexes altında Oku : Dizini Oku'ya tıklayın.

9. Aynı sayfada Veri eylemleri'ne geçin ve Microsoft.Search/searchServices/indexes/documents altında Oku : Belgeleri Oku'ya tıklayın.

   JSON tanımı aşağıdaki örneğe benzer:

   {
    "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. Rolü oluşturmak için Gözden geçir + oluştur'u seçin. Artık role kullanıcı ve grup atayabilirsiniz.

PowerShell örneği, Arama Dizini Veri Okuyucusu'nun kopyası olan ancak tüm dizinleri ada göre listeleyebilen özel bir rol oluşturmaya yönelik JSON söz dizimini gösterir.

1. Hangilerine ihtiyacınız olduğunu belirlemek için atomik izinler listesini gözden geçirin. Bu örnekte aşağıdakilere ihtiyacınız olacaktır:

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

2. Özel rolü oluşturmak için bir PowerShell oturumu ayarlayın. Ayrıntılı yönergeler için bkz. Azure PowerShell

3. Rol tanımını JSON belgesi olarak sağlayın. Aşağıdaki örnek, PowerShell ile özel rol oluşturmaya yönelik söz dizimini gösterir.

{
  "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. Hangilerine ihtiyacınız olduğunu belirlemek için atomik izinler listesini gözden geçirin.

2. Adımlar için bkz . REST API kullanarak Azure özel rolleri oluşturma veya güncelleştirme.

3. Rol kopyalayın veya oluşturun ya da özel rolü belirtmek için JSON kullanın (JSON söz dizimi için PowerShell sekmesine bakın).

1. Hangilerine ihtiyacınız olduğunu belirlemek için atomik izinler listesini gözden geçirin.

2. Adımlar için bkz . Azure CLI kullanarak Azure özel rolleri oluşturma veya güncelleştirme.

3. JSON söz dizimi için PowerShell sekmesine bakın.