Yönetilen Kimliği Azure İletişim Hizmetleri ile kullanma

Makale
10/27/2023

Azure İletişim Hizmetleri, geliştiricilerin uygulamalarına gerçek zamanlı iletişim özellikleri oluşturmasını sağlayan tam olarak yönetilen bir iletişim platformudur. Yönetilen Kimlik'i Azure İletişim Hizmetleri kullanarak uygulamanız için kimlik doğrulama işlemini basitleştirebilir ve ayrıca güvenliğini artırabilirsiniz. Bu belge, yönetilen kimliğin Azure İletişim Hizmetleri ile nasıl kullanılacağını kapsar.

yönetilen kimliği Azure İletişim Hizmetleri ile kullanma

Azure İletişim Hizmetleri, hizmette kimlik doğrulaması yapmak için Yönetilen Kimlik'in kullanılmasını destekler. Yönetilen Kimlik'i kullanarak kendi erişim belirteçlerinizi ve kimlik bilgilerinizi yönetme gereksinimini ortadan kaldırabilirsiniz.

Azure İletişim Hizmetleri kaynağınıza iki tür kimlik atanabilir:

Kaynağınıza bağlı olan ve kaynağınız silindiğinde silinen Sistem Tarafından Atanan Kimlik. Kaynağınız yalnızca bir sistem tarafından atanan kimliğe sahip olabilir.
Azure İletişim Hizmetleri kaynağınıza atanabilen bir Azure kaynağı olan Kullanıcı Tarafından Atanan Kimlik. Kaynağınız silindiğinde bu kimlik silinmez. Kaynağınızda kullanıcı tarafından atanan birden çok kimlik olabilir.

Yönetilen Kimliği Azure İletişim Hizmetleri kullanmak için şu adımları izleyin:

Yönetilen Kimliğinize İletişim Hizmetleri kaynağına erişim verin. Bu atama Azure portalı, Azure CLI ve Azure İletişim Yönetimi SDK'ları aracılığıyla yapılabilir.
Azure İletişim Hizmetleri ile kimlik doğrulaması yapmak için Yönetilen Kimlik'i kullanın. Kimlik doğrulaması, Yönetilen Kimliği destekleyen Azure SDK'ları veya REST API'leri aracılığıyla yapılabilir.

Uygulamanızın sayfasının sol gezinti bölmesinde aşağı kaydırarak Ayarlar grubuna gelin.
Kimlik'i seçin.
Sistem tarafından atanan sekmesinde Durum'aAçık olarak geçin. Kaydet'i seçin.

az communication identity assign Sistem tarafından atanan bir kimlik atamak için komutunu çalıştırın:

az communication identity assign --system-assigned --name myApp --resource-group myResourceGroup

Kullanıcı tarafından atanan kimlik ekleme

Azure İletişim Hizmetleri kaynağınıza kullanıcı tarafından atanan bir kimlik atamak için önce kimliği oluşturmanız ve ardından kaynak tanımlayıcısını İletişim hizmeti kaynağınıza eklemeniz gerekir.

Azure portalı
Azure CLI

İlk olarak, kullanıcı tarafından atanan bir yönetilen kimlik kaynağı oluşturmanız gerekir.

Bu yönergelere göre kullanıcı tarafından atanan bir yönetilen kimlik kaynağı oluşturun.
Uygulamanızın sayfasının sol gezinti bölmesinde aşağı kaydırarak Ayarlar grubuna gelin.
Kimlik'i seçin.
Kullanıcı tarafından atanan>Ekle'yi seçin.
Daha önce oluşturduğunuz kimliği arayın, seçin ve Ekle'yi seçin.

Kullanıcı tarafından atanan bir kimlik oluşturun.

az identity create --resource-group <group-name> --name <identity-name>

az communication identity assign Kullanıcı tarafından atanan bir kimlik atamak için komutunu çalıştırın:

az communication identity assign --name myApp --resource-group myResourceGroup --user-assigned <identity-id>

Azure İletişim Hizmetleri yönetim SDK'larını kullanan Yönetilen Kimlik

Yönetilen Kimlik, Azure İletişim Yönetimi SDK'ları kullanılarak Azure İletişim Hizmetleri kaynağınıza da atanabilir. Bu atama, oluşturma sırasında veya kaynağı güncelleştirirken kaynak tanımına kimlik özelliği eklenerek elde edilebilir.

üzerinde özelliğini CommunicationServiceResourceData ayarlayarak Identity .NET için Azure İletişim Yönetimi SDK'sını kullanarak yönetilen kimliğinizi Azure İletişim Hizmetleri kaynağınıza atayabilirsiniz.

Örneğin:

public async Task CreateResourceWithSystemAssignedManagedIdentity()
{
    ArmClient armClient = new ArmClient(new DefaultAzureCredential());
    SubscriptionResource subscription = await armClient.GetDefaultSubscriptionAsync();

    //Create Resource group
    ResourceGroupCollection rgCollection = subscription.GetResourceGroups();
    // With the collection, we can create a new resource group with an specific name
    string rgName = "myRgName";
    AzureLocation location = AzureLocation.WestUS2;
    ArmOperation<ResourceGroupResource> lro = await rgCollection.CreateOrUpdateAsync(WaitUntil.Completed, rgName, new ResourceGroupData(location));
    ResourceGroupResource resourceGroup = lro.Value;

    // get resource group collection
    CommunicationServiceResourceCollection collection = resourceGroup.GetCommunicationServiceResources();
    string communicationServiceName = "myCommunicationService";
    
    // Create Communication Service Resource
    var identity = new ManagedServiceIdentity(ManagedServiceIdentityType.SystemAssigned);
    CommunicationServiceResourceData data = new CommunicationServiceResourceData("global")
    {
        DataLocation = "UnitedStates",
        Identity = identity
    };
    var communicationServiceLro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, communicationServiceName, data);
    var resource = communicationServiceLro.Value;
}

.NET Yönetim SDK'sını kullanma hakkında daha fazla bilgi için bkz . .NET için Azure İletişim Yönetimi SDK'sı.

Kaynak örneğinizi yönetmeye özgü daha fazla bilgi için bkz . İletişim Hizmeti Kaynak örneğinizi yönetme

Not

Bir kaynağın hem sistem tarafından atanan hem de kullanıcı tarafından atanan kimlikleri aynı anda olabilir. Bu durumda özelliği type olacaktır SystemAssigned,UserAssigned.

Bir kaynaktan tüm yönetilen kimlik atamalarının kaldırılması, özelliği olarak Nonebelirtilerek type de elde edilebilir.

Sonraki adımlar

Artık Azure İletişim Hizmetleri ile Yönetilen Kimlik'i etkinleştirmeyi öğrendinsiniz. Kimlik doğrulama işleminizi basitleştirmek ve güvenliği geliştirmek için bu özelliği kendi uygulamalarınızda uygulamayı göz önünde bulundurun.

Yönetilen Kimliği Azure İletişim Hizmetleri ile kullanma