Aracılığıyla paylaş

Özel bağlayıcılara genel bakış

  • Makale

Azure Logic Apps, Microsoft Power Automate Microsoft'a ve Microsoft Power Apps doğrulanmış hizmetlere bağlanmak için 1.000'den fazla bağlayıcı sunarken, önceden oluşturulmuş bağlayıcılar olarak kullanılamayan hizmetlerle iletişim kurmak isteyebilirsiniz. Özel bağlayıcılar, kendi tetikleyicileri ve eylemleriyle bir bağlayıcı oluşturmanıza (ve hatta paylaşmanıza) izin vererek bu senaryoyu çözmenizi sağlar.

Özel bağlayıcıların Metin Analizi API'si ile uygulamalar arasında nasıl köprü kurduğunu gösteren ekran görüntüsü.

Yaşam Döngüsü

Beş aşamada özel bağlayıcı yaşam döngüsünün ekran görüntüsü.

1. API'nizi oluşturun

Özel bağlayıcı, Logic Apps'in Power Automate veya Power Apps'in bu REST veya SOAP API ile iletişim kurmasını sağlayan bir REST API etrafındaki sarmalayıcıdır. Bu API'ler şunlar olabilir:

Logic Apps ayrıca SOAP API'lerini de destekler.

Oluşturmayı ve yönetmeyi planladığınız ortak API 'Ler için aşağıdaki Microsoft Azure ürünlerden birini kullanmayı düşünebilirsiniz:

Özel API'ler için Microsoft, şirket içi veri ağ geçidi aracılığıyla şirket içi veri bağlantısı sunar.

2. API'nizin güvenliğini sağlama

API'leriniz ve bağlayıcılarınız için şu standart kimlik doğrulama yöntemlerinden birini kullanın (Microsoft Entra kimlik önerilir):

Kimlik doğrulama uygulamak zorunda olmadığınız için Azure portalda API'niz için Microsoft Entra ID kimlik doğrulaması ayarlayabilirsiniz. Veya API'nizin kodunda kimlik doğrulaması yapılmasını zorunlu kılabilirsiniz. Özel bağlayıcılar için kimlik hakkında Microsoft Entra daha fazla bilgi için bkz: API'nizi ve bağlayıcınızı kimlikle Microsoft Entra güvenli hale getirme.

2.1. OAuth 2.0

Otomatik olarak kimlik doğrulaması yapmak için 2.0 kullanan OAuth yeni oluşturulan özel bağlayıcılar, bağlayıcı başına yeniden yönlendirme URI'sine sahiptir. Mevcut OAuth 2.0 bağlayıcıları, 17 Şubat 2024'ten önce bağlayıcı başına yeniden yönlendirme URI'si kullanacak şekilde güncelleştirilmelidir.

  • Özel bağlayıcılarınızı web arabirimiyle oluşturduysanız, özel bağlayıcılarınızı düzenleyin, Güvenlik sekmesine gidin ve benzersiz yeniden yönlendirme URL'sine güncelleştir kutusunu işaretleyin ve ardından bağlayıcı başına yeniden yönlendirme URI'sini etkinleştirmek içinkaydedin.
  • Komut satırı arabirimi (CLI) aracını kullanarak çoklu kimlik doğrulaması ileözel bağlayıcılarınızı oluşturduysanız, ayarlamak "redirectMode": "GlobalPerConnector" için CLI aracını kullanarak bağlayıcınızı güncelleştirmeniz gerekir.
  • Özel bağlayıcılar, Güvenlik sekmesindeki ayar veya CLI aracı aracılığıyla bağlayıcı başına yeniden yönlendirme URI'sini kullanacak şekilde güncelleştirildikten sonra, genel yeniden yönlendirme URI'sini OAuth 2.0 uygulamalarınızdan kaldırın. Yeni oluşturulan benzersiz yönlendirme URL'sini OAuth 2.0 uygulamalarınıza eklemelisiniz.
  • Bu güncelleştirmeyi 17 Şubat 2024'ten itibaren mevcut OAuth 2.0 özel bağlayıcıları için zorunlu kılacağız. Bağlayıcı başına yeniden yönlendirme URI'si kullanacak şekilde güncelleştirilmeyen herhangi bir özel bağlayıcı, yeni bağlantılar için çalışmayı durdurur ve kullanıcıya bir hata iletisi gösterir.
  • Bağlayıcı yeniden yönlendirme URL'si başına geçirmek için hangi özel bağlayıcıların güncelleştirmeye ihtiyacı olduğunu öğrenmek için, Yönetici bağlayıcısı için Özel Bağlayıcıları Yönetici Olarak Al eylemini kullanan Power Apps bir akış oluşturabilir ve sonucunu ayrıştırabilirsiniz. Bu makalenin ilerleyen kısımlarında eklenen akış, tüm özel bağlayıcıları aynısını kullanarak getirir. Ardından, Oauth olmayan özel bağlayıcıyı filtrelemek için bağlantı parametresinin özelliğine bir filtre koşulu uygular ve ardından yalnızca bağlayıcı başına benzersiz yeniden yönlendirme URL'sini kullanmayan bağlayıcıları seçmek için başka bir filtre uygular. Son olarak, seçilen özel bağlayıcıları akışın başında başlatılan bir dizi değişkenine yerleştirir ve bu bağlayıcıların adını ve oluşturucusunu gösteren bir HTML tablosu oluşturur. Bu çözümü içeri aktararakbu akışı ortamınıza aktarabilirsiniz. HTML tablosunu kendinize e-posta olarak göndermek için akışı daha da genişletebilirsiniz. Veya bağlayıcı oluşturuculara doğrudan e-posta gönderecek ve güncellenmesi gereken bağlayıcının adlarını onlara sağlayacak şekilde genişletebilirsiniz.

3. API'yi açıklama ve özel bağlayıcıyı tanımlama

Kimliği doğrulanmış erişime sahip bir API 'ye sahip olduktan sonra, yapılacak bir sonraki şey API 'nizi kullanarak Logic Apps, Power Automate veya Power Apps API'nizin iletişim kurabilmesini sağlar. Aşağıdaki yaklaşımlar desteklenmektedir:

OpenAPI tanımları ve Postman Koleksiyonları farklı biçimler kullanır ancak her ikisi de API'nizi açıklayan, dilden bağımsız, makine tarafından okunabilir belgelerdir. Bu belgeleri, API'nizin kullandığı dil ve platform temelinde çeşitli araçlardan oluşturabilirsiniz. Arka planda Logic Apps, Power Automate ve Power Apps bağlayıcıları tanımlamak için OpenAPI kullanır.

4. Bağlayıcınızı bir Logic App, Power Automate veya Power Apps uygulamasında kullanın

Özel bağlayıcılar önceden oluşturulmuş bağlayıcılarla aynı şekilde kullanılır. Özel bağlayıcınızda kullanıma sunduğunuz herhangi bir işlemi çağırmak amacıyla bu bağlantıyı kullanmak için API'nize bir bağlantı oluşturmanız gerekir.

'da Power Automate oluşturulan bağlayıcılar şurada Power Apps kullanılabilir ve 'de Power Apps oluşturulan bağlayıcılar 'da Power Automate kullanılabilir. Bu kullanılabilirlik Logic Apps'te oluşturulan bağlayıcılar için geçerli değildir. Ancak, bu hizmetlerden herhangi birinde bağlayıcıyı yeniden oluşturmak için OpenAPI tanımı veya Postman koleksiyonunu yeniden kullanabilirsiniz. Daha fazla bilgi için ilgili öğreticiye bakın:

İpucu

API'deki bir alanı güncelleştirirseniz (kaldırır, ekler veya değiştirirseniz) şu adımları gerçekleştirin:

  1. API için güncelleştirilmiş Swagger'a bakması için bağlayıcıyı yeniden yayımlayın.
  2. Bu bağlayıcıyı kullanan herhangi bir uygulamadaki herhangi bir bağlantıyı/veri kaynağını kaldırın.
  3. Bu bağlayıcı için bağlantıyı / veri kaynağını uygulamalara yeniden ekleyin.

5. Bağlayıcınızı paylaşın

Logic Apps, Power Automate veya Power Apps'te paylaştığınız şekilde kuruluşunuzdaki kullanıcılarla bağlayıcınızı paylaşabilirsiniz. Paylaşım isteğe bağlıdır ancak bağlayıcılarınızı diğer kullanıcılarla paylaşmak istediğiniz senaryolarınız olabilir.

Kuruluşunuzda özel bağlayıcıları paylaşma bölümündedaha fazla bilgi edinin.

6. Bağlayıcınızı onaylayın

Bağlayıcınızı Logic Apps, Power Automate ve Power Apps'teki tüm kullanıcılarla paylaşmak istiyorsanız bu bağlayıcıyı onaylanmak üzere Microsoft'a gönderebilirsiniz. Microsoft bağlayıcınızı gözden geçirip teknik uyumluluğu ve içerik uyumluluğunu denetleyerek işlevselliğini doğrular.

Daha fazla bilgi için bkz: Microsoft sertifikası için bağlayıcılarınızı gönderme.

Sanal Ağ desteği

Bağlayıcı bir Sanal Ağa Power Platform bağlı birortamda kullanıldığında sınırlamalar geçerlidir:

  • Özel kod kullanıldığında, sınırlamalar Özel bağlayıcıda kod yazma bölümündeaçıklanmıştır.

  • Ortam bir Sanal Ağ ile ilişkilendirilmeden önce oluşturulan özel bağlayıcıların yeniden kaydedilmesi gerekir.

  • Özel bağlayıcıya geri çağrı yapmayan konum üst bilgisini döndüren tetikleyiciler desteklenmez.

Geri bildirimde bulunun

Bağlayıcı platformumuzla veya yeni özellik fikirlerimizle ilgili sorunlar hakkındaki geri bildirimleriniz bizim için çok önemlidir. Geri bildirim sağlamak için Sorun gönderme veya bağlayıcılarla ilgili yardım alma bölümüne gidin ve geri bildirim türünüzü seçin.