Aracılığıyla paylaş

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

  • Makale

Azure Logic Apps Microsoft Power Automate ve Microsoft Power Apps, Microsoft'a bağlanmak ve hizmetleri doğrulamak için 1.000'in üzerinde bağlayıcı sunsa da önceden oluşturulmuş bağlayıcı 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'sini uygulamalarla nasıl köprülediğini 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:

  • Genel (ortak Internet üzerinde görünür); Örneğin, Spotify, Slack, Rackspace, veya yönettiğiniz API gibi.
  • Özel (yalnızca ağınızda görünür).

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 üzerinden ş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 bu standart kimlik doğrulama yöntemlerinden birini kullanın (Microsoft Entra ID ö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ılarda Microsoft Entra ID hakkında daha fazla bilgi için bkz. API ve bağlayıcınızı Microsoft Entra ID ile koruma.

2.1. OAuth 2.0

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

  • Web arabirimiyle özel bağlayıcılar oluşturduysanız özel bağlayıcılarınızı düzenleyin, Güvenlik sekmesine ve Benzersiz yeniden yönlendirme URL'si olarak güncelleştir onay kutusuna gidin ve ardından bağlayıcı başına yeniden yönlendirme URI'sini etkinleştirmek için kaydedin.
  • Özel bağlayıcılarınızı komut satırı arabirimi (CLI) aracını kullanarak çoklu kimlik doğrulama ile oluşturduysanız "redirectMode": "GlobalPerConnector" ayarı 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, OAuth 2.0 uygulamalarınızdan genel yeniden yönlendirme URI'sini kaldırın. Yeni oluşturulan benzersiz yönlendirme URL'sini OAuth 2.0 uygulamalarınıza eklemeniz gerekir.
  • Bu güncelleştirmeyi 17 Şubat 2024 tarihinden itibaren mevcut OAuth 2.0 özel bağlayıcıları için uygulayacağı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. Daha sonra, Oauth dışı ö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 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çe aktararak bu 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.

'de 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'da 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 tüm bağlantıları / 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ünde daha 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.

Ek bilgi için bkz. Bağlayıcınızı onay için Microsoft'a gönderme.

Sanal Ağ desteği

Bağlayıcı, Sanal Ağa bağlı bir Power Platform ortamı üzerinde 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ünde açıklanmıştır.

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

Geri bildirimde bulunun

Bağlayıcı platformumuzla ilgili sorunlar veya yeni özellik fikirleri hakkındaki geri bildiriminiz bizim için çok önemlidir. Geri bildirimde bulunmak için Sorun gönderme veya bağlayıcılarla ilgili yardım alma bölümüne gidip geri bildirim türünü seçin.