Yönetilen kimlik kullanma
Bu makalede, Azure Web PubSub'da yönetilen kimlik oluşturma ve kullanma adımları gösterilmektedir.
Önemli
Azure Web PubSub yalnızca bir yönetilen kimliği destekleyebilir. Sistem tarafından atanan bir kimlik veya kullanıcı tarafından atanan bir kimlik ekleyebilirsiniz.
Sistem tarafından atanan kimlik ekleme
Azure portalında yönetilen kimlik ayarlamak için bir Azure Web PubSub örneği oluşturun ve ardından özelliği açın.
Azure portalında bir Web PubSub kaynağı oluşturun. Portalda kaynağa gidin.
Soldaki menüde Kimlik'i seçin.
Sistem tarafından atanan sekmesini seçin ve Ardından Durum seçeneğini Açık olarak ayarlayın. Kaydet'i seçin.
Kullanıcı tarafından atanan kimlik ekleme
Kullanıcı tarafından atanan bir kimlik kullanarak bir Web PubSub kaynağı oluşturmak için, kimliği oluşturun ve ardından kimliğin kaynak tanımlayıcısını hizmetinize ekleyin.
Kullanıcı tarafından atanan bir yönetilen kimlik kaynağı oluşturun.
Azure portalında bir Web PubSub kaynağı oluşturun. Portalda kaynağa gidin.
Soldaki menüde Kimlik'i seçin.
Kullanıcı tarafından atanan sekmesini ve ardından Ekle'yi seçin.
Oluşturduğunuz kimliği arayın ve seçin. Ekle'yi seçin.
İstemci olayları senaryolarında yönetilen kimlik kullanma
Azure Web PubSub tam olarak yönetilen bir hizmet olduğundan, belirteçleri el ile almak için yönetilen kimlik kullanamazsınız. Bunun yerine, Web PubSub olayları bir olay işleyicisine gönderdiğinde, erişim belirteci almak için yönetilen kimliği kullanır. Hizmet daha sonra HTTP isteğinin Authorization üst bilgisinde erişim belirtecini ayarlar.
Olay işleyicisi için yönetilen kimlik kimlik doğrulamasını ayarlama
Sistem tarafından atanan bir kimlik veya kullanıcı tarafından atanan bir kimlik ekleyin.
Hub ayarlarını yapılandırma'ya gidin ve yukarı akış olay işleyicisi ekleyin veya düzenleyin.
Kimlik Doğrulaması'nın altında Yönetilen Kimliği Kullan'ı seçin ve ardından Verilen belirteç hedef kitlesini belirtin onay kutusunu seçin. Hedef kitle, erişim belirtecindeki talep olur
aud. Talep, olay işleyiciniz için doğrulamanın bir parçası olabilir.Kimlik doğrulaması için şu seçeneklerden birini belirleyebilirsiniz:
- Mevcut bir Microsoft Entra uygulamasını kullanın. Seçtiğiniz uygulamanın uygulama kimliği kullanılır.
- Hizmet sorumlusunun Uygulama Kimliği URI'sini kullanın.
Önemli
Boş bir kaynağın kullanılması aslında Microsoft Graph için bir belirteç hedefi alır. Şu anda Microsoft Graph belirteç şifrelemesini etkinleştirdiğinden, bir uygulamanın Microsoft Graph dışında belirtecin kimliğini doğrulaması desteklenmez. Yukarı akış hedefinizi temsil etmek için her zaman bir hizmet sorumlusu oluşturmanız gerekir. Oluşturduğunuz hizmet sorumlusu için Uygulama Kimliği veya Uygulama Kimliği URI değerini ayarlayın.
Azure İşlevleri uygulamasında kimlik doğrulaması
Kod değişikliği yapmadan İşlevler uygulaması için erişim doğrulamasını kolayca ayarlayabilirsiniz.
Azure portalında İşlevler uygulamasına gidin.
Soldaki menüde Kimlik Doğrulaması'nı seçin.
Kimlik sağlayıcısı ekle'yi seçin.
Temel Bilgiler sekmesinde, Kimlik sağlayıcısı için Microsoft'u seçin.
İsteğin kimliği doğrulanmadığında eylemin gerçekleştirilmesi için Microsoft Entra Id ile oturum aç'ı seçin.
Yeni kayıt oluşturma seçeneği varsayılan olarak seçilidir. Kaydın adını değiştirebilirsiniz. Microsoft Entra sağlayıcısını etkinleştirme hakkında daha fazla bilgi için bkz. Azure Uygulaması Hizmetinizi veya Azure İşlevleri uygulamanızı Microsoft Entra Id oturum açma bilgilerini kullanacak şekilde yapılandırma.
Web PubSub kaynağınıza gidin ve sistem tarafından atanan bir kimlik veya kullanıcı tarafından atanan bir kimlik ekleyin.
Web PubSub kaynağınızın sol menüsünde Ayarlar'ı seçin.
Hub ayarlarınızı düzenlemek için Düzenle'yi ve ardından olay işleyicisi ayarlarınızı düzenlemek için Düzenle'yi seçin. Kimlik Doğrulaması'nın altında Yönetilen Kimliği Kullan'ı seçin ve Var olan uygulamalardan seç onay kutusunu seçin. Oluşturduğunuz uygulamayı seçin.
Bu ayarları yapılandırdıktan sonra İşlevler uygulaması üst bilgide erişim belirteci olmayan istekleri reddeder.
Erişim belirtecini doğrulama
Azure Uygulaması Hizmeti veya Azure İşlevleri Web Apps özelliğini kullanmıyorsanız belirteci de doğrulayabilirsiniz.
Üst bilgideki Authorization belirteç Microsoft kimlik platformu erişim belirtecidir.
Erişim belirtecini doğrulamak için uygulamanızın hedef kitleyi ve imzalama belirtecini de doğrulaması gerekir. İmzalama belirteçleri, OpenID bulma belgesindeki değerlerle doğrulanmalıdır. Bir örnek için belgenin kiracıdan bağımsız sürümüne bakın.
Microsoft Entra ara yazılımının erişim belirteçlerini doğrulamaya yönelik yerleşik özellikleri vardır. Kullanmak istediğiniz dilde yazılmış bir örnek bulmak için örneklerimize göz atabilirsiniz.
Belirteç doğrulamanın nasıl işleneceğini gösteren kitaplıklar ve kod örnekleri sağlıyoruz. JSON Web Belirteci (JWT) doğrulaması için çeşitli açık kaynak iş ortağı kitaplıkları da kullanılabilir. Neredeyse her platform ve dil için en az bir seçenek vardır. Microsoft Entra yetkilendirme kitaplıkları ve kod örnekleri hakkında daha fazla bilgi için bkz. kimlik doğrulama kitaplıklarını Microsoft kimlik platformu.
Olay işleyicisi Azure İşlevleri veya Web Apps'te barındırıyorsa, kolay bir yol Microsoft Entra oturum açmayı yapılandırmaktır.
Anahtar kasası başvurusu için yönetilen kimlik kullanma
Web PubSub, yönetilen kimlik kullanarak gizli dizi almak için bir anahtar kasasına erişebilir.
Azure Web PubSub için sistem tarafından atanan bir kimlik veya kullanıcı tarafından atanan bir kimlik ekleyin.
Anahtar kasasında, erişim ilkelerini kullanarak yönetilen kimlik için gizli dizi okuma izinleri verin. Daha fazla bilgi için bkz . Azure portalında anahtar kasası erişim ilkesi atama.
Şu anda bu özellik aşağıdaki senaryoda kullanılabilir:
- Olay işleyicisi URL şablonu ayarında anahtar kasasından gizli dizileri almak için söz dizimini
{@Microsoft.KeyVault(SecretUri=<secret-identity>)}kullanın.