Microsoft Entra Id ile HTTP (önceden yetkilendirilmiş)

Çeşitli Web hizmetlerinden, Microsoft Entra kimliğiyle veya şirket içi bir web hizmetinden kimlik doğrulaması yapılan kaynakları getirmek için HTTP bağlayıcısını kullanın.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet	Class	Bölgeler
Copilot Studio	Premium	Tüm Power Automate bölgeleri
Logic Apps	Standart	Aşağıdakiler dışında tüm Logic Apps bölgeleri : - ABD Savunma Bakanlığı (DoD)
Power Apps	Premium	Tüm Power Apps bölgeleri
Power Automate	Premium	Tüm Power Automate bölgeleri

İletişim
İsim	Microsoft
URL	Microsoft LogicApps Desteği Microsoft Power Automate Desteği Microsoft Power Apps Desteği

Bağlayıcı Meta Verileri
Publisher	Microsoft

Uyarı

Microsoft Entra Id (önceden kimliği doğrulanmış) olan HTTP bağlayıcısı, kullanıcıların Entra Id kimlik doğrulamasını destekleyen herhangi bir HTTP uç noktasına istek göndermesine olanak tanır. Güvenliği ve veri gizliliğini iyileştirmeye yönelik devam eden çabalarımızın bir parçası olarak, bu bağlayıcıyla ilişkili izinleri gözden geçirdik ve gelişmiş kimlik yalıtımı denetimleri sağlamayı planlıyoruz.

Şu anda, Microsoft Entra ID (önceden yetkilendirilmiş) bağlayıcısı olan HTTP, Microsoft 1. taraf güvenilir uygulaması aracılığıyla çalışır. Bu uygulama Microsoft Graph, SharePoint ve diğer Microsoft teklifleri dahil ancak bunlarla sınırlı olmamak üzere çeşitli Microsoft hizmetleri için ön kimlik doğrulaması içerir. Bu ön yetkilendirme, bağlayıcının kullanıcı adına temsilci erişimi kullanarak bu hizmetlerle etkileşim kurmasını sağlar. Bu yaklaşımın kullanıcının ayrıcalıklarına tamamen uyuldığından ve yetkili kapsamı dışındaki verilere veya eylemlere erişime izin vermediğinden emin olabilirsiniz.

Mevcut bağlayıcıda, yöneticilerin uygulama tarafından kullanıcı adına yürütülecek eylemler için açıkça onay vermesine gerek yoktur. Ancak, bu bağlayıcının yeni bir sürümünü yayımladık. Bağlayıcının yeni sürümü, ön kimlik doğrulaması olmadan yeni bir uygulama kullanır. Bu, yöneticinin ayrı bir onay vermesine olanak tanır.

Bu bağlayıcının kullanımını kısıtlamak istiyorsanız mevcut Veri Kaybı Önleme (DLP) özelliklerinden yararlanabilirsiniz. Bu bağlayıcının kullanımını engellemek için yeni bir ilke oluşturma veya mevcut ilkeyi güncelleştirme seçeneğiniz vardır. Diğer bazı bağlayıcıların ve özelliklerin Microsoft Entra ID (önceden kimlik doğrulaması) bağlayıcısı olan HTTP'ye bağlı olduğunu unutmayın. Daha fazla bilgi için buraya tıklayın.

Power Platform Yönetim Merkezi

Sanal Ağ desteği (Alt Ağ Temsilcisi)

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

Aşağıdaki eylemler desteklenmeyen eylemlerdir:
- Web kaynağı alma

Bilinen Sorunlar ve Sınırlamalar

Bağlayıcı, istek gövdesini base64 kodlamasına kodlar, bu nedenle istek gövdesini bu biçimde bekleyen arka uç hizmetlerini çağırmak için kullanılmalıdır. İstek gövdesini ham ikili biçimde bekleyen bir arka uç hizmetini çağırmak için bu bağlayıcıyı kullanamazsınız.
Şuna benzer bir hata alırsanız:

{ "error": { "code": "Forbidden", "message": "" } }
{ "error": { "code": "Authorization_RequestDenied", "message": "Insufficient privileges to complete the operation." } } bunun nedeni, bu bağlayıcının sınırlı bir kapsam kümesine sahip olması olabilir.
Kullanıcılar desteklenmeyen bazı kaynaklara bağlanırken ön yetkilendirme hatalarıyla da karşılaşabilir.
Senaryonuz daha gelişmiş bir şey gerektiriyorsa lütfen "HTTP" bağlayıcısını kullanın veya özel bir bağlayıcı oluşturun.

Bağlayıcı, çok kiracılı uygulama kaydını temel alır. Kullanıcı oturum açıncaya kadar uygulama kullanıcının hangi kiracıdan olduğunu anlayamaz. Bu nedenle, yalnızca kullanıcıların varsayılan kiracısı ('common') altında kaynak belirtmeyi destekliyoruz.
ADFS SSO (Tek Sign-Oniçin Microsoft Entra ID Federasyon Hizmetleri) tabanlı kaynaklar desteklenmez. Geçici bir çözüm olarak lütfen "HTTP" bağlayıcısını kullanın.
Bu bağlayıcıyı ulusal bulut ortamında kullanırken kaynağın kendi ulusal bulut uç noktası eşdeğeri olması gerekir . Ulusal bulut ortamlarının çoğundan genel buluta (https://graph.microsoft.com https://bing.comörneğin) bağlanma denemeleri ön yetkilendirme hatasıyla başarısız olur.
- GCC ve Fairfax ortamları genel bulut uç noktalarını (https://graph.microsoft.comörneğin) kullanmaya devam edebilir.
- GCC-High kaynak örneği: https://graph.microsoft.us.
- Çin kaynak örneği: https://microsoftgraph.chinacloudapi.cn.
Şirket içi veri ağ geçidi etkinleştirilmiş bağlantı durumunda tanımlama bilgisi yetkilendirme isteği üst bilgisinin kullanılması desteklenmez.
Yanıt Konumu üst bilgisini temel alan zaman uyumsuz desen desteklenmez. Varsa lütfen bunun yerine Azure Resource Manager bağlayıcısı kullanın.
'Microsoft Entra Id ile HTTP' bağlayıcısının başka bir hizmetten verileri başarıyla alması için, bağlayıcı tarafından kullanılan uygulamaya gerekli kapsama erişim verilmelidir. Uygulamaya gerekli erişimi verme hakkında ayrıntılı bilgi için Bkz. Uygulamayı oturum açmış bir kullanıcı adına işlem yapma yetkisi verme. Gerekli erişim verilmezse, bağlantıyı oluşturmaya çalıştığınızda aşağıdaki hatalardan birini alabilirsiniz:
```
Consent Required: To enable the HTTP With Microsoft Entra ID connector to access resources on behalf of a signed-in user, grant consent to this application.
```
Bir kapsam (izin) verildiyse ancak tüm gerekli kapsamlar dahil edilmezse, bağlantının oluşturulması başarılı olur, ancak çalışma zamanında Yasak (403) hatasıyla karşılaşırsınız. Hata ayrıntıları aşağıdakiler gibi ek bilgileri içerebilir:
```
"code": "Authorization_RequestDenied"
"message": "Insufficient privileges to complete the operation."
```
Bağlantı oluştururken sorunlarla karşılaşırsanız veya eksik parametre değeriyle ilgili bir hata alınırsa, Yeni Tasarımcı yerine Power Automate'in Eski Tasarımcısı ile bağlantı oluşturmayı deneyin.
Ön yetkilendirmelerin kaldırılması veya eklenmesi, güncelleştirmeden önce var olan bağlantıların yansıtılması 1 saat kadar sürebilir. Ancak yeni bağlantılar, güncelleştirilmiş yetkilendirmeleri anında yansıtmalıdır.

Bağlayıcıyı oturum açmış bir kullanıcı adına işlem yapma yetkisi verme

Genel Yönetici rolüne sahip bir kullanıcı olarak, gerekli hizmet için gerekli izinleri (kapsamları) onaylamak için oAuth2PermissionGrants oluşturmanız gerekir.

Örneğin, Microsoft Graph (https://graph.microsoft.com) kullanıyorsanız ve takvim bilgilerini okumanız gerekiyorsa, gerekli izinleri (Calendar.Read) belirlemek için Graph belgelerini izleyebilirsiniz. Uygulamaya (bağlayıcı tarafından kullanılan) Calendar.Read kapsamı vererek, uygulamanın kullanıcı adına hizmetten bu verilere erişmesine izin verir. Dikkat edilmesi gereken önemli noktalardan biri, uygulama tarafından erişilebilen verilerin hala kullanıcının hizmette erişimi olan veriyle sınırlı olmasıdır. Bu uygulamaya onay vermek için Azure Portal'ı kullanmak mümkün değildir. Bu nedenle, Microsoft Entra ID bağlayıcısı ile HTTP tarafından kullanılan uygulamaya onay verilmesini basitleştirmek için Microsoft tarafından bir PowerShell betiği oluşturulmuştur.

Önemli

Bu betiği çalıştırmak için PowerShell sürüm 7 veya üzeri yüklenmelidir.

Gerekli PowerShell betiğini buradan indirin veya burada belirtilen adımlara başvuran 'ManagePermissionGrant.ps1' adlı bir betik oluşturun. Bu betik esas olarak başvuru amaçlıdır, betiği kullanım örneğiniz gibi değiştirebilirsiniz.
İndirilen ManagePermissionGrant.ps1 dosyasına sağ tıklayın ve ardından Özellikler'e tıklayın.
Engeli Kaldır onay kutusuna ve ardından Tamam'a tıklayın.

Engellemeyi Kaldır onay kutusunu işaretlemezseniz, betiğin dijital olarak imzalanmadığından yüklenemeyeceğini belirten bir hata alırsınız.
PowerShell komut penceresini açın.
Yolu, betiği indirdiğiniz konuma değiştirin.
Aşağıdaki komutu yazın ve Enter tuşuna basın:
```
.\ ManagePermissionGrant.ps1
```
Azure Genel'de kimlik doğrulaması yapmayı (önerilen) veya bir listeden (gelişmiş) seçim yapmayı seçmeniz istenir. US Gov, US Gov DoD, Çin veya Almanya'daki aboneliklere bağlanmıyorsanız Enter tuşuna basın.
Henüz yapmadıysanız, yeni bir tarayıcı penceresinde Microsoft kimlik platformunda kimlik doğrulaması yapmanız istenebilir. Genel Yönetici rolüyle kullanıcı olarak kimlik doğrulaması yapın.
Microsoft Graph veya SharePoint gibi en çok kullanılan hizmetlerden bazılarına onay vermek için Enter tuşuna basın. Onaylamanız gereken hizmet yaygın olarak kullanılan uygulamalar listesinde değilse A seçeneğini kullanın.
Bir iletişim kutusu görüntülenir. Bağlayıcının bir kullanıcı adına davranmasına izin vermek için onay vermek istediğiniz uygulamayı seçin. Sonuçları filtrelemek için üstteki metin kutusunu kullanabilirsiniz.
Tamam'a tıklayın.
Onay vermek istediğiniz bir veya daha fazla kapsam (izin) seçin ve tamam'a tıklayın. Satırlar seçilirken CTRL tuşuna basılıp basılı tutularak birden çok kapsam seçilebilir.
PowerShell penceresinde onay türünü seçmeniz istenir. Uygulamanın oturum açmış herhangi bir kullanıcı adına hareket etmesine izin vermeyi veya onayı belirli bir kullanıcıyla sınırlamayı seçebilirsiniz. Tüm kullanıcılar için onay sağlamak istiyorsanız Enter tuşuna basın. Yalnızca belirli bir kullanıcı için onay vermek istiyorsanız , N yazın ve Enter tuşuna basın. Belirli bir kullanıcı için onay vermeyi seçerseniz, kullanıcıyı seçmeniz istenir.
Seçili kaynak için zaten herhangi bir kapsam için onay varsa, önce mevcut izinleri silmek isteyip istemediğiniz sorulur. Var olan izinleri silmek istiyorsanız Y yazın ve Enter tuşuna basın. Mevcut izinleri korumak istiyorsanız Enter tuşuna basın.
Seçtiğiniz kapsamların özeti PowerShell penceresinde görüntülenir. Seçili kapsamları verme işlemine devam etmek istiyorsanız Y yazın ve Enter tuşuna basın.
Betik onayı başarıyla verebilirse, betik yürütme işleminin tamamlandığını belirten bir ileti görürsünüz.

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:


Temel Ağ Geçidi kullanarak oturum açma	HTTP kaynaklarınıza bağlanmak için temel bir web ağ geçidi kullanma	Tüm bölgeler	Paylaşılabilir
İstemci Sertifikası Kimlik Doğrulaması kullanarak oturum açma	PFX sertifikasını ve parolasını kullanarak Microsoft Entra Id kimlik bilgilerini sağlayın	Tüm bölgeler	Paylaşılabilir
Windows Gateway kullanarak oturum açma	HTTP kaynaklarınıza bağlanmak için şirket içi Bir Windows Gateway kullanma	Tüm bölgeler	Paylaşılabilir
Anonim Ağ Geçidi kullanarak oturum açma	HTTP kaynaklarınıza bağlanmak için anonim ağ geçidi kullanma	Tüm bölgeler	Paylaşılabilir
Microsoft Entra Kimliği ile oturum açın	Microsoft Entra Id Kimlik Bilgileri ile oturum açma	Tüm bölgeler	Paylaşılabilir
Varsayılan [KULLANIM DIŞI]	Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.	Tüm bölgeler	Paylaşılamaz

Temel Ağ Geçidi kullanarak oturum açma

Kimlik Doğrulama Kimliği: BasicGateway

Geçerli: Tüm bölgeler

HTTP kaynaklarınıza bağlanmak için temel bir web ağ geçidi kullanma

Bu, paylaşılabilir bir bağlantıdır. Power app başka bir kullanıcıyla paylaşılıyorsa, bağlantı da paylaşılır. Daha fazla bilgi için bkz . Tuval uygulamaları için bağlayıcılara genel bakış - Power Apps | Microsoft Docs

İsim	Türü	Description	Gerekli
Temel Kaynak URL'si	String	HTTP kaynaklarının veya Uygulama (istemci) kimliğinin temel URL'sini bağlanmak istediğiniz GUID biçiminde belirtin.	Doğru
Kullanıcı adı	securestring	Kullanıcı adı kimlik bilgileri
Şifre	securestring	Parola kimlik bilgileri
Gateway	gatewaySetting	Şirket içi ağ geçidi (daha fazla ayrıntı için bkz.https://docs.microsoft.com/data-integration/gateway

İstemci Sertifikası Kimlik Doğrulaması kullanarak oturum açma

Kimlik Doğrulama Kimliği: CertOauth

Geçerli: Tüm bölgeler

PFX sertifikasını ve parolasını kullanarak Microsoft Entra Id kimlik bilgilerini sağlayın

İsim	Türü	Description	Gerekli
Microsoft Entra Id Kaynak URI'si (Uygulama Kimliği URI'si)	String	Hedef kaynağı tanımlamak için Microsoft Entra Id'de kullanılan tanımlayıcı. SharePoint Online ve OneDrive İş için https://{contoso}.sharepoint.com kullanın. Genellikle kaynağınızın temel URL'si olur.	Doğru
Temel Kaynak URL'si	String	HTTP kaynaklarının veya Uygulama (istemci) kimliğinin temel URL'sini bağlanmak istediğiniz GUID biçiminde belirtin.	Doğru
Tenant	String		Doğru
Müşteri Kimliği	String	Microsoft Entra Id uygulaması için istemci kimliği	Doğru
İstemci sertifikası gizli dizisi	istemci sertifikası	Bu uygulama tarafından izin verilen istemci sertifikası gizli dizisi	Doğru

Windows Gateway kullanarak oturum açma

Kimlik Doğrulama Kimliği: WindowsGateway

Geçerli: Tüm bölgeler

HTTP kaynaklarınıza bağlanmak için şirket içi Bir Windows Gateway kullanma

İsim	Türü	Description	Gerekli
Temel Kaynak URL'si	String	HTTP kaynaklarının veya Uygulama (istemci) kimliğinin temel URL'sini bağlanmak istediğiniz GUID biçiminde belirtin.	Doğru
Kullanıcı adı	securestring	Kullanıcı adı kimlik bilgileri
Şifre	securestring	Parola kimlik bilgileri
Gateway	gatewaySetting	Şirket içi ağ geçidi (daha fazla ayrıntı için bkz.https://docs.microsoft.com/data-integration/gateway

Anonim Ağ Geçidi kullanarak oturum açma

Kimlik Doğrulama Kimliği: AnonymousGateway

Geçerli: Tüm bölgeler

HTTP kaynaklarınıza bağlanmak için anonim ağ geçidi kullanma

İsim	Türü	Description	Gerekli
Temel Kaynak URL'si	String	HTTP kaynaklarının veya Uygulama (istemci) kimliğinin temel URL'sini bağlanmak istediğiniz GUID biçiminde belirtin.	Doğru
Kullanıcı adı	securestring	Kullanıcı adı kimlik bilgileri
Şifre	securestring	Parola kimlik bilgileri
Gateway	gatewaySetting	Şirket içi ağ geçidi (daha fazla ayrıntı için bkz.https://docs.microsoft.com/data-integration/gateway

Microsoft Entra Kimliği ile oturum açın

Kimlik Doğrulama Kimliği: EntraAuth

Geçerli: Tüm bölgeler

Microsoft Entra Id Kimlik Bilgileri ile oturum açma

İsim	Türü	Description	Gerekli
Microsoft Entra Id Kaynak URI'si (Uygulama Kimliği URI'si)	String	Hedef kaynağı tanımlamak için Microsoft Entra Id'de kullanılan tanımlayıcı. SharePoint Online ve OneDrive İş için https://{contoso}.sharepoint.com kullanın. Genellikle kaynağınızın temel URL'si olur.	Doğru
Temel Kaynak URL'si	String	HTTP kaynaklarının veya Uygulama (istemci) kimliğinin temel URL'sini bağlanmak istediğiniz GUID biçiminde belirtin.	Doğru

Varsayılan [KULLANIM DIŞI]

Geçerli: Tüm bölgeler

Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Gerekli
Microsoft Entra Id Kaynak URI'si (Uygulama Kimliği URI'si)	String	Hedef kaynağı tanımlamak için Microsoft Entra Id'de kullanılan tanımlayıcı. SharePoint Online ve OneDrive İş için https://{contoso}.sharepoint.com kullanın. Genellikle kaynağınızın temel URL'si olur.	Doğru
Temel Kaynak URL'si	String	HTTP kaynaklarının veya Uygulama (istemci) kimliğinin temel URL'sini bağlanmak istediğiniz GUID biçiminde belirtin.	Doğru
Kullanıcı adı	securestring	Kullanıcı adı kimlik bilgileri
Şifre	securestring	Parola kimlik bilgileri
Kimlik Doğrulaması Türü	String	Şirket içi HTTP kaynağınıza bağlanmak için kimlik doğrulama türü
Gateway	gatewaySetting	Şirket içi ağ geçidi (daha fazla ayrıntı için bkz.https://docs.microsoft.com/data-integration/gateway

Azaltma Sınırları

Name	Çağrılar	Yenileme Dönemi
Bağlantı başına API çağrıları	100	60 saniye

Eylemler

HTTP isteği çağırma	HTTP uç noktasını çağırır.
Web kaynağı alma	HTTP GET isteği vererek bir web kaynağı alır.

HTTP isteği çağırma

İşlem Kimliği:: InvokeHttp

HTTP uç noktasını çağırır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Yöntem	method	True	string	Bilinen HTTP fiillerinden biri: GET, DELETE, PATCH, POST, PUT.
İsteğin url'si	url	True	string	Kaynağın tam veya göreli URL'si. Tam URL ise, bağlantıda ayarlanan temel kaynak URL'si ile eşleşmelidir.
Headers	headers		object	İstek üst bilgileri.
İsteğin gövdesi	body		string	Yöntemi gerektirdiğinde isteğin gövdesi.

Döndürülenler

Yanıtın içeriği.

Body: string

Web kaynağı alma

İşlem Kimliği:: GetFileContent

HTTP GET isteği vererek bir web kaynağı alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kaynak yolu	path	True	string	Dosya tanımlayıcısı

Döndürülenler

Dosyanın içeriği.

Dosya İçeriği: binary

Tanımlar

ikili

Bu, 'ikili' temel veri türüdür.

Aracılığıyla paylaş

Microsoft Entra Id ile HTTP (önceden yetkilendirilmiş)

Sanal Ağ desteği (Alt Ağ Temsilcisi)

Bilinen Sorunlar ve Sınırlamalar

Bağlayıcıyı oturum açmış bir kullanıcı adına işlem yapma yetkisi verme

Bağlantı oluşturma

Temel Ağ Geçidi kullanarak oturum açma

İstemci Sertifikası Kimlik Doğrulaması kullanarak oturum açma

Windows Gateway kullanarak oturum açma

Anonim Ağ Geçidi kullanarak oturum açma

Microsoft Entra Kimliği ile oturum açın

Varsayılan [KULLANIM DIŞI]

Azaltma Sınırları

Eylemler

HTTP isteği çağırma

Parametreler

Döndürülenler

Web kaynağı alma

Parametreler

Döndürülenler

Tanımlar

ikili