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

Azure Logic Apps, Microsoft Power Automate, Microsoft Power Apps ve Microsoft Copilot Studio , Microsoft'a ve doğrulanmış hizmetlere bağlanmak için 1.000'den fazla bağlayıcı sunar, ancak ö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 Analizleri API'si ile uygulamalar arasında nasıl köprü oluşturduğ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, Power Apps veya Copilot Studio'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 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.

  • 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 yönlendirme URI'sini kullanacak şekilde güncellendiğinde, genel 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üncellemeyi 17 Şubat 2024'ten 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 tüm özel bağlayıcılar, yeni bağlantılar için çalışmayı durdurur ve kullanıcıya bir hata iletisi gösterir.
  • Bağlayıcı yönlendirme URL'si başına hangi özel bağlayıcıların güncellenmesi gerektiğini bulmak için, Yönetici bağlayıcısı için Yönetici Olarak Özel Bağlayıcıları Al eylemini Power Apps olarak kullanan 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ç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, Power Apps veya Copilot Studio 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, Power Apps ve Copilot Studio bağlayıcıları tanımlamak için OpenAPI kullanır.

4. Bağlayıcınızı bir Copilot Studio, Logic Apps, 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.

Power Automate'de oluşturulan bağlayıcılar Power Apps ve Copilot Studio'te, Power Apps'e oluşturulan bağlayıcılar ise Power Automate ve Copilot Studio'da mevcuttur. Bu kullanılabilirlik, 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:

İpucu

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

  1. API'nin güncelleştirilmiş Swagger'ına 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ının bağlantısını/veri kaynağını uygulamalara yeniden ekleyin.

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

Bağlayıcınızı; kullanıcılarla Copilot Studio, Logic Apps, Power Automate veya Power Apps'te kaynakları paylaştığınız gibi 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.

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ı Copilot Studio, 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.

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 bir bağlayıcıya 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.

  • Özel bağlayıcıya geri çağırmayan konum üst bilgisi 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 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.

  • Last updated on