Belge Çevirisi için yönetilen kimlikler

Makale
02/12/2024

Azure kaynakları için yönetilen kimlikler, Microsoft Entra kimliği ve Azure yönetilen kaynakları için belirli izinler oluşturan hizmet sorumlularıdır. Yönetilen kimlikler, depolama verilerine erişim vermenin ve paylaşılan erişim imzası belirteçlerini (SAS) kaynak ve hedef URL'lerinizle ekleme gereksinimini değiştirmenin daha güvenli bir yoludur.

Screenshot of managed identity flow (RBAC).

Kendi uygulamalarınız da dahil olmak üzere Microsoft Entra kimlik doğrulamasını destekleyen herhangi bir kaynağa erişim vermek için yönetilen kimlikleri kullanabilirsiniz.
Azure kaynağına erişim vermek için Azure rol tabanlı erişim denetimini () kullanarak yönetilen kimliğe Azure rolü atayın.Azure RBAC
Azure'da yönetilen kimlikleri kullanmak için ek maliyet yoktur.

Önemli

Yönetilen kimlikleri kullanırken HTTP isteklerinize sas belirteci URL'si eklemeyin; istekleriniz başarısız olur. Yönetilen kimlikleri kullanmak, kaynak ve hedef URL'lerinizle paylaşılan erişim imzası belirteçlerini (SAS) ekleme gereksiniminin yerini alır.
Belge Çevirisi işlemleri için yönetilen kimlikleri kullanmak için Çeviri kaynağınızı Doğu ABD gibi belirli bir coğrafi Azure bölgesinde oluşturmanız gerekir. Çeviri kaynak bölgeniz Genel olarak ayarlandıysa, Belge Çevirisi için yönetilen kimliği kullanamazsınız. Belge Çevirisi için Paylaşılan Erişim İmzası belirteçlerini (SAS) kullanmaya devam edebilirsiniz.
Belge Çevirisi yalnızca S1 Standart Hizmet Planı'nda (kullandıkça öde) veya D3 Toplu İndirim Planı'nda kullanılabilir. Bkz.Azure AI hizmetleri fiyatlandırması— Çeviri.

Önkoşullar

Başlamak için gerekli olanlar:

Etkin bir Azure hesabınız yoksa ücretsiz bir hesap oluşturabilirsiniz.
Batı ABD gibi bir coğrafi bölgeye atanmış tek hizmetli bir Çeviri (çok hizmetli azure yapay zeka hizmetleri değil) kaynağı. Ayrıntılı adımlar için bkz. Çok hizmetli kaynak oluşturma.
Azure portalını kullanarak Azure rol tabanlı erişim denetimi (Azure RBAC) hakkında kısa bir bilgi.
Çeviri kaynağınızla aynı bölgede yer alan bir Azure Blob Depolama hesabı. Blob verilerinizi depolama hesabınızda depolamak ve düzenlemek için de kapsayıcılar oluşturmanız gerekir.
Depolama hesabınız bir güvenlik duvarının arkasındaysa aşağıdaki yapılandırmayı etkinleştirmeniz gerekir:
1. Azure portalına gidin ve Azure hesabınızla oturum açın.
2. Depolama hesabını seçin.
3. Sol bölmedeki Güvenlik + ağ grubunda Ağ'ı seçin.
4. Güvenlik duvarları ve sanal ağlar sekmesinde Seçili sanal ağlardan ve IP adreslerinden etkinleştirildi'yi seçin.
5. Tüm onay kutularının seçimini kaldırın.
6. Microsoft ağ yönlendirmesi'nin seçili olduğundan emin olun.
7. Kaynak örnekleri bölümünde kaynak türü olarak Microsoft.CognitiveServices/accounts öğesini seçin ve örnek adı olarak Çeviri kaynağınızı seçin.
8. Güvenilen hizmetler listesindeki Azure hizmetlerinin bu depolama hesabına erişmesine izin ver kutusunun işaretli olduğundan emin olun. Özel durumları yönetme hakkında daha fazla bilgi için bkz. Azure Depolama güvenlik duvarlarını ve sanal ağları yapılandırma.
9. Kaydet'i seçin.
  
  Not
  
  Ağ değişikliklerinin yayılması 5 dakika kadar sürebilir.
Ağ erişimine izin verilse de, Çeviri kaynağınız Depolama hesabınızdaki verilere hala erişemiyor. Çeviri kaynağınız için yönetilen kimlik oluşturmanız ve belirli bir erişim rolü atamanız gerekir.

Yönetilen kimlik atamaları

İki tür yönetilen kimlik vardır: sistem tarafından atanan ve kullanıcı tarafından atanan. Şu anda, Belge Çevirisi sistem tarafından atanan yönetilen kimliği destekler:

Sistem tarafından atanan yönetilen kimlik doğrudan bir hizmet örneğinde etkinleştirilir . Varsayılan olarak etkin değildir; kaynağınıza gidip kimlik ayarını güncelleştirmeniz gerekir.
Sistem tarafından atanan yönetilen kimlik, yaşam döngüsü boyunca kaynağınıza bağlıdır. Kaynağınızı silerseniz yönetilen kimlik de silinir.

Aşağıdaki adımlarda, sistem tarafından atanan yönetilen kimliği etkinleştirir ve Çeviri kaynağınıza Azure Blob Depolama hesabınıza sınırlı erişim veririz.

Sistem tarafından atanan yönetilen kimliği etkinleştirme

Blob oluşturabilmesi, okuyabilmesi veya silebilmesi için önce depolama hesabınıza Çeviri kaynak erişimi vermelisiniz. sistem tarafından atanan yönetilen kimlikle Çeviri kaynağını etkinleştirdikten sonra, Azure depolama kapsayıcılarınıza Çeviri erişim vermek için Azure rol tabanlı erişim denetimini ()Azure RBAC kullanabilirsiniz.

Azure portalına gidin ve Azure hesabınızla oturum açın.
Çeviri kaynağını seçin.
Sol bölmedeki Kaynak Yönetimi grubunda Kimlik'i seçin.
Sistem tarafından atanan sekmesinde Durum iki durumlu düğmesini açın.

Önemli

Kullanıcı tarafından atanan yönetilen kimlik, toplu transkripsiyon depolama hesabı senaryosunun gereksinimlerini karşılamaz. Sistem tarafından atanan yönetilen kimliği etkinleştirdiğinizden emin olun.
Kaydet'i seçin.

Çeviri kaynağınız için depolama hesabı erişimi verme

Önemli

Sistem tarafından atanan yönetilen kimlik rolü atamak için, depolama kaynağının depolama kapsamında Sahip veya Kullanıcı Erişimi Yönetici istrator gibi Microsoft.Authorization/roleAssignments/write izinlerine sahip olmanız gerekir.

Azure portalına gidin ve Azure hesabınızla oturum açın.
Çeviri kaynağını seçin.
Sol bölmedeki Kaynak Yönetimi grubunda Kimlik'i seçin.
İzinler'in altında Azure rol atamaları'ı seçin:
Açılan Azure rol atamaları sayfasında, açılan menüden aboneliğinizi seçin ve ardından + Rol ataması ekle'yi seçin.
Ardından, Çeviri hizmet kaynağınıza Depolama bir Blob Veri Katkıda Bulunanı rolü atayın. Depolama Blob Veri Katkıda Bulunanı rolü Çeviri (sistem tarafından atanan yönetilen kimlik tarafından temsil edilir) blob kapsayıcısına ve verilerine okuma, yazma ve silme erişimi verir. Rol ataması ekle açılır penceresinde, alanları aşağıdaki gibi doldurun ve Kaydet'i seçin:

Alan Değer

Scope Depolama.

Abonelik Depolama kaynağınızla ilişkili abonelik.

Kaynak Depolama kaynağınızın adı.

Rol Blob Veri Katkıda Bulunanı'Depolama.
Rol ataması eklendi onay iletisi görüntülendikten sonra eklenen rol atamasını görmek için sayfayı yenileyin.
Yeni rol atamasını hemen görmüyorsanız bekleyin ve sayfayı yenilemeyi yeniden deneyin. Rol atamalarını atadığınızda veya kaldırdığınızda değişikliklerin geçerlilik kazanması 30 dakika kadar sürebilir.

Alan	Değer
Scope	*Depolama*.
Abonelik	*Depolama kaynağınızla* ilişkili abonelik.
Kaynak	*Depolama kaynağınızın* adı.
Rol	*Blob Veri Katkıda Bulunanı'Depolama*.

HTTP istekleri

Post isteği aracılığıyla Çeviri hizmet uç noktanıza zaman uyumsuz bir toplu çeviri isteği gönderilir.
Yönetilen kimlik ve Azure RBACile artık SAS URL'lerini eklemeniz gerekmez.
Başarılı olursa POST yöntemi bir 202 Accepted yanıt kodu döndürür ve hizmet bir toplu iş isteği oluşturur.
Çevrilen belgeler hedef kapsayıcınızda görünür.

Üst Bilgiler

Her Belge Çevirisi API'sinin isteğine aşağıdaki üst bilgiler eklenir:

HTTP üst bilgisi	Açıklama
Ocp-Apim-Subscription-Key	Gerekli: Değer, Çeviri veya Azure AI hizmetleri kaynağınızın Azure anahtarıdır.
İçerik Türü	Gerekli: Yükün içerik türünü belirtir. Kabul edilen değerler application/json veya charset=UTF-8 değerleridir.

POST isteği gövdesi

İstek URL'si POST https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.1/batchesşeklindedir.
İstek gövdesi adlı inputsbir JSON nesnesidir.
inputs nesnesi, kaynak ve targetURL hedef dil çiftleriniz için hem hem de sourceURL kapsayıcı adreslerini içerir. Sistem tarafından atanan yönetilen kimlikle, düz Depolama Hesap URL'si (SAS veya başka eklemeler olmadan) kullanırsınız. Biçim şöyledir: https://<storage_account_name>.blob.core.windows.net/<container_name>.
prefix ve suffix alanları (isteğe bağlı), klasörler de dahil olmak üzere kapsayıcıdaki belgeleri filtrelemek için kullanılır.
Belge çevrilirken alan için glossaries bir değer (isteğe bağlı) uygulanır.
targetUrl Her hedef dil için benzersiz olmalıdır.

Önemli

Hedefte aynı ada sahip bir dosya zaten varsa, iş başarısız olur. Yönetilen kimlikleri kullanırken, HTTP isteklerinize SAS belirteci URL'si eklemeyin. Bunu yaparsanız istekleriniz başarısız olur.

Kapsayıcıdaki tüm belgeleri çevirme

Bu örnek istek gövdesi, tüm belgelerin hedef dile çevrilmesi için bir kaynak kapsayıcıya başvurur.

Daha fazla bilgi için bkz. İstek parametreleri.

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://<storage_account_name>.blob.core.windows.net/<source_container_name>"
            },
            "targets": [
                {
                    "targetUrl": "https://<storage_account_name>.blob.core.windows.net/<target_container_name>"
                    "language": "fr"
                }
            ]
        }
    ]
}

Kapsayıcıdaki belirli bir belgeyi çevirme

Bu örnek istek gövdesi, iki hedef dile çevrilecek tek bir kaynak belgeye başvurur.

Önemli

Daha önce belirtilen istek parametrelerine ek olarak eklemeniz gerekir"storageType": "File". Aksi takdirde kaynak URL'nin kapsayıcı düzeyinde olduğu varsayılır.

{
    "inputs": [
        {
            "storageType": "File",
            "source": {
                "sourceUrl": "https://<storage_account_name>.blob.core.windows.net/<source_container_name>/source-english.docx"
            },
            "targets": [
                {
                    "targetUrl": "https://<storage_account_name>.blob.core.windows.net/<target_container_name>/Target-Spanish.docx"
                    "language": "es"
                },
                {
                    "targetUrl": "https://<storage_account_name>.blob.core.windows.net/<target_container_name>/Target-German.docx",
                    "language": "de"
                }
            ]
        }
    ]
}

Özel sözlük kullanarak kapsayıcıdaki tüm belgeleri çevirme

Bu örnek istek gövdesi, tüm belgelerin bir sözlük kullanılarak hedef dile çevrilmesi için bir kaynak kapsayıcıya başvurur.

Daha fazla bilgi için bkz. İstek parametreleri.

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://<storage_account_name>.blob.core.windows.net/<source_container_name>",
                "filter": {
                    "prefix": "myfolder/"
                }
            },
            "targets": [
                {
                    "targetUrl": "https://<storage_account_name>.blob.core.windows.net/<target_container_name>",
                    "language": "es",
                    "glossaries": [
                        {
                            "glossaryUrl": "https://<storage_account_name>.blob.core.windows.net/<glossary_container_name>/en-es.xlf",
                            "format": "xliff"
                        }
                    ]
                }
            ]
        }
    ]
}

Harika! Sistem tarafından atanan yönetilen kimliği etkinleştirmeyi ve kullanmayı öğrendinsiniz. Azure Kaynakları ve Azure RBACiçin yönetilen kimlikle, HTTP isteklerinize SAS belirteçleri eklemeden depolama kaynağınıza Çeviri belirli erişim hakları vermişsinizdir.

Sonraki adımlar

Hızlı Başlangıç: Belge Çevirisi'ne başlama

Öğretici: Yönetilen kimlikleri kullanarak web uygulamasından Azure Depolama erişme

Belge Çevirisi için yönetilen kimlikler

Önkoşullar

Yönetilen kimlik atamaları

Sistem tarafından atanan yönetilen kimliği etkinleştirme

Çeviri kaynağınız için depolama hesabı erişimi verme

HTTP istekleri

Üst Bilgiler

POST isteği gövdesi

Kapsayıcıdaki tüm belgeleri çevirme

Kapsayıcıdaki belirli bir belgeyi çevirme

Özel sözlük kullanarak kapsayıcıdaki tüm belgeleri çevirme

Sonraki adımlar

Ek kaynaklar