Özel bağlayıcılar

  • Makale

Azure Logic Apps, Microsoft Power Automate ve Microsoft Power Apps Microsoft hizmetlerine ve doğrulanmış hizmetlere bağlanmak için 1,000 bağlayıcı sunar. Ancak, önceden oluşturulmuş bağlayıcı olarak sağlanmayan hizmetlerle de iletişim kurmanız gerekebilir. Ö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.

Screenshot of custom connectors - overview.

Yaşam Döngüsü

Screenshot of custom connectors - lifecycle.

1. API'nizi oluşturun

Özel bir bağlayıcı; Logic Apps, Power Automate veya Power Apps'in REST veya SOAP apı ile iletişim kurmasına olanak sağlayan bir REST API (Logic Apps SOAP apı 'lerini de destekler) etrafında bir 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).

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 üzerinden veya CLI aracını kullanarak) bağlayıcı başına yeniden yönlendirme URI'sini kullanacak şekilde güncelleştirildiğinde genel yeniden yönlendirme URI'sini OAuth 2.0 uygulamalarınızdan kaldırmanız ve yeni oluşturulan benzersiz yeniden 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'sini kullanacak şekilde güncelleştirilmemiş özel bağlayıcılar, yeni bağlantılar için çalışmayı durduracak ve kullanıcıya bir hata iletisi gösterilecektir.
  • Bağlayıcı yönlendirme URL'sine göre hangi özel bağlayıcıların geçiş için bir güncellemeye ihtiyaç duyduğunu öğrenmek için Power Apps'ın Özel Bağlayıcıları Yönetici Olarak Al eylemini kullanan basit bir akış oluşturabilir ve sonucu paylaşabilirsiniz. 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 akışı yalnızca bu çözümü içe aktararak 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. API’nize bir bağlantı oluşturmanız gerekir. Ardından bu bağlantıyı kullanarak, özel bağlayıcınızda kullanıma sunduğunuz işlemlere çağrı yapabilirsiniz.

Power Automate uygulamasında oluşturulan bağlayıcılar uygulamasında Power Apps kullanılabilir durumdadır. Aynı şekilde, Power Apps uygulamasında oluşturulan bağlayıcılar uygulamasında Power Automate kullanılabilir durumdadır. Bu, Logic Apps'te oluşturulan bağlayıcılar için doğru 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:

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 olabilir.

Daha fazla bilgi için bkz. Özel bağlayıcıyı kuruluşunuzda paylaşma.

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çirir, teknik ve içerik uyumluluğunu denetler ve işlevselliği doğrular.

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

Öğretici

Öğretici, Bilişsel Hizmetler Metin Analizi API 'sini kullanır. Microsoft bu API için zaten bir bağlayıcı sağlamaktadır. Özel bağlayıcı yaşam döngüsünü öğretme ve özel bağlayıcıların benzersiz senaryoları nasıl destekleyebileceği konusunda iyi bir örnektir.

Senaryo

Oluşturacağınız bağlayıcı, metin girişi için yaklaşım puanını (0,000 ila 1000) döndüren Metin Analizi Duyarlılığı işlemini gösterir.

Ön koşullar

  • Aşağıdaki aboneliklerden birini:

  • Logic Apps, Power Automate akışları veya Power Apps oluşturma konusunda temel bilgi sahibi.

  • Bilişsel Hizmetler Metin Analizleri API’si için bir API anahtarı.

API anahtarı alın

Metin analizi API'si, kullanıcıların kimliğini doğrulamak için API anahtarı kullanır. Bir kullanıcı özel bir bağlayıcıyla API ile bağlantı oluşturduğunda, bu anahtarın değerini belirtir. Bir API anahtarı almak için:

Öğreticiyi başlatma

Gelişmiş kılavuz

Bu bölümdeki öğreticiler ve video, uygulamalarınızın parçası olarak Power Platform bağlayıcılarından faydalanmanız için gerekli içgörüleri sağlar.

Eğitimler

Aşağıdaki öğreticiler belirli özel bağlayıcı senaryoları için daha ayrıntılı bilgi sağlar:

Görüntülü

Aşağıdaki 45 dakikalık video Power Platform bağlayıcılarının nasıl çalıştığını göstermektedir. Ayrıca basit ve gelişmiş özel bağlayıcıların nasıl oluşturulacağını gösterir.

Ayrıca bkz.

Tüm bağlayıcıların listesi

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.