cURL ile ASP.NET Core web API'si çağırma

Bu makalede, İstemci URL'sini (cURL) kullanarak korumalı ASP.NET Core web API'sini nasıl çağırabileceğiniz gösterilir. cURL, geliştiricilerin bir sunucuya ve sunucudan veri aktarmak için kullandığı bir komut satırı aracıdır. Bu makalede, bir web uygulamasını ve bir web API'sini bir kiracıya kaydedersiniz. Web uygulaması, Microsoft kimlik platformu tarafından oluşturulan bir erişim belirtecini almak için kullanılır. Ardından, cURL kullanarak web API'sine yetkili bir çağrı yapmak için belirteci kullanırsınız.

Bu makalede, İstemci URL'sini (cURL) kullanarak korumalı ASP.NET Core web API'sini nasıl çağırabileceğiniz gösterilir. cURL, geliştiricilerin bir sunucuya ve sunucudan veri aktarmak için kullandığı bir komut satırı aracıdır. Öğretici: API'nize korumalı bir uç nokta uygulama bölümünü takiben, korumalı bir API oluşturduğunuz yerde, bir erişim belirteci oluşturmak için Microsoft Kimlik Platformu'na bir web uygulaması kaydetmeniz gerekir. Ardından, cURL kullanarak API'ye yetkili bir çağrı yapmak için belirteci kullanırsınız.

Önkoşullar

Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.
Bu Azure hesabının uygulamaları yönetme izinleri olmalıdır. Aşağıdaki Microsoft Entra rollerinden herhangi biri gerekli izinleri içerir:
- Uygulama Yöneticisi
- Uygulama Geliştirici
- Bulut Uygulaması Yöneticisi
İş istasyonu bilgisayarınıza cURL indirip yükleyin.
En düşük .NET 8.0 SDK gereksinimi.

Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.
Bu Azure hesabının uygulamaları yönetme izinleri olmalıdır. Aşağıdaki Microsoft Entra rollerinden herhangi biri gerekli izinleri içerir:
- Uygulama Yöneticisi
- Uygulama Geliştirici
- Bulut Uygulaması Yöneticisi
Öğretici serisinin tamamlanması:
İş istasyonu bilgisayarınıza cURL indirip yükleyin.

Microsoft kimlik platformu ile uygulama kaydetme

Microsoft kimlik platformu, kimlik ve erişim yönetimi hizmetleri sağlamadan önce uygulamanızın kaydedilmesini gerektirir. Uygulama kaydı, uygulamanın adını, türünü ve oturum açma hedef kitlesini belirtmenize olanak tanır. Oturum açma hedef kitlesi, belirli bir uygulamada hangi tür kullanıcı hesaplarının oturum açmasına izin verildiğini belirtir.

Web API'sini kaydetme

Web API kaydını oluşturmak için şu adımları izleyin:

Microsoft Entra yönetim merkezinde en azından Uygulama Geliştiricisi olarak oturum açın.
Birden çok kiracıya erişiminiz varsa, Dizinler + abonelikler menüsünden uygulamayı kaydetmek istediğiniz kiracıya geçmek için üst menüdeki Ayarlar simgesini kullanın.
Entra ID>Uygulama Kayıtları’na göz atın.
Yeni kayıt'ı seçin.
Uygulama için NewWebAPI1 gibi bir Ad girin.
Desteklenen hesap türleri içinYalnızca bu kuruluş dizinindeki Hesaplar'ı seçin. Farklı hesap türleri hakkında bilgi için Seçmeme Yardım Et seçeneğini belirleyin.
Kaydet'i seçin.
Kayıt tamamlandığında uygulamanın Genel Bakış bölmesi görüntülenir. Uygulama kaynak kodunuzda kullanılacak Dizin (kiracı) kimliğini ve Uygulama (istemci) kimliğini kaydedin.

Not

Desteklenen hesap türleri, Uygulama tarafından desteklenen hesapları değiştirme konusuna başvurarak değiştirilebilir.

API'yi kullanıma sunma

API kaydedildikten sonra, API'nin istemci uygulamalarına sunduğu kapsamları tanımlayarak api'nin iznini yapılandırabilirsiniz. İstemci uygulamaları, korumalı web API'sine istekleriyle birlikte bir erişim belirteci geçirerek işlemleri gerçekleştirmek için izin istemektedir. Web API'si daha sonra istenen işlemi yalnızca aldığı erişim belirteci geçerliyse gerçekleştirir.

Yönet'in altında API'yi > kullanıma sunma Kapsam ekle'yi seçin. Kaydet ve devam et'i seçerek önerilen (api://{clientId}) kabul edin. {clientId}, Genel Bakış sayfasından kaydedilen değerdir. Ardından aşağıdaki bilgileri girin:
1. Kapsam adı olarak girinForecast.Read.
2. Kim onaylayabilir? için Yöneticiler ve kullanıcılar seçeneğinin belirlendiğinden emin olun.
3. Yönetici onayı görünen adı kutusuna Read forecast data yazın.
4. Yönetici onayı açıklaması kutusuna yazınAllows the application to read weather forecast data.
5. Kullanıcı onayı görünen adı kutusuna Read forecast data yazın.
6. Kullanıcı onayı açıklaması kutusuna girinAllows the application to read weather forecast data.
7. Durum'unEtkin olarak ayarlandığından emin olun.
Kapsam ekle'yi seçin. Kapsam doğru girilmişse, API'yi kullanıma sunma bölmesinde listelenir.

Web uygulamasını kaydetme

Ancak web API'sine sahip olmak yeterli değildir, çünkü oluşturduğunuz web API'sine erişmek için bir erişim belirteci almak için de bir web uygulaması gerekir.

Web uygulaması kaydını oluşturmak için şu adımları izleyin:

Giriş sayfasına dönmek için Giriş'i seçin. Entra ID>Uygulama Kayıtları’na göz atın.
Yeni kayıt'ı seçin.
Uygulama için bir Ad girin, örneğin web-app-calls-web-api.
Desteklenen hesap türleri içinYalnızca bu kuruluş dizinindeki Hesaplar'ı seçin. Farklı hesap türleri hakkında bilgi için Bana yardım et seçeneğini belirleyin.
Yeniden Yönlendirme URI'si (isteğe bağlı) altındaWeb'i seçin ve URL metin kutusuna girinhttp://localhost.
Kaydet'i seçin.

Microsoft Entra yönetim merkezinde en azından Uygulama Geliştiricisi olarak oturum açın.
Birden çok kiracıya erişiminiz varsa, Dizinler + abonelikler menüsünden uygulamayı kaydetmek istediğiniz kiracıya geçmek için üst menüdeki Ayarlar simgesini kullanın.
Entra ID>Uygulama Kayıtları’na göz atın.
Yeni kayıt'ı seçin.
Uygulama için, örneğin web-app-calls-web-api, bir ad girin.
Desteklenen hesap türleri içinYalnızca bu kuruluş dizinindeki Hesaplar'ı seçin. Farklı hesap türleri hakkında bilgi için Bana yardım et seçeneğini belirleyin.
Yeniden Yönlendirme URI'si (isteğe bağlı) altındaWeb'i seçin ve URL metin kutusuna girinhttp://localhost.
Kaydet'i seçin.

Kayıt tamamlandığında, uygulama kaydı Genel Bakış bölmesinde görüntülenir. Sonraki adımlarda kullanılacak Dizin (kiracı) kimliğini ve Uygulama (istemci) kimliğini kaydedin.

İstemci gizli anahtarı ekle

İstemci gizli dizisi, uygulamanızın kendisini kimlik doğrulaması için kullanabileceği bir dize değeridir ve bazen uygulama parolası olarak da adlandırılır. Web uygulaması, belirteç istediğinde kimliğini kanıtlamak için istemci gizli anahtarını kullanır.

İstemci sırrını yapılandırmak için şu adımları izleyin:

Genel Bakış bölmesindeki Yönet'in altında Sertifikalar & sırlar>İstemci sırları>Yeni istemci sırrı'nı seçin.
İstemci sırrınız için bir açıklama ekleyin, örneğin İstemci sırrım.
Gizli anahtar için bir son kullanma tarihi seçin veya özel bir yaşam süresi belirtin.
- Bir gizli anahtarın ömrü iki yıl (24 ay) veya daha kısa bir süreyle sınırlıdır. 24 aydan uzun bir özel yaşam süresi belirtemezsiniz.
- Microsoft, 12 aydan kısa bir süre sonu değeri ayarlamanızı önerir.
Ekle'yi seçin.
İstemci gizli sırrının Değerini kaydettiğinizden emin olun. Bu gizli değer, bu sayfadan ayrıldıktan sonra bir daha asla gösterilmez.

Web API'sine erişime izin vermek için uygulama izinleri ekleme

Web uygulaması kaydında bir web API'sinin kapsamlarını belirterek, web uygulaması Microsoft kimlik platformu tarafından sağlanan kapsamları içeren bir erişim belirteci alabilir. Kod içinde web API'si daha sonra erişim belirtecinde bulunan kapsamlara göre kaynaklarına izin tabanlı erişim sağlayabilir.

Web API'sine yönelik web uygulaması izinlerini yapılandırmak için şu adımları izleyin:

Web uygulamanızın Genel Bakış bölmesinden (web-app-that-calls-web-api), Yönet'in altında API izinleri> izin API'leri >ekle'yiseçin.
YeniWebAPI1'i veya izin eklemek istediğiniz API'yi seçin.
İzinleri seç altında, Forecast.Read'in yanındaki kutuyu işaretleyin. İzin listesini genişletmeniz gerekebilir. Bu, istemci uygulamasının oturum açmış kullanıcı adına sahip olması gereken izinleri seçer.
İşlemi tamamlamak için İzin ekle'yi seçin.

BU izinleri API'nize ekledikten sonra , Yapılandırılmış izinler altında seçili izinleri görmeniz gerekir.

Microsoft Graph API'sinin User.Read iznini de fark edebilirsiniz. Bu izin, bir uygulamayı kaydettiğinizde otomatik olarak eklenir.

Web API'sini test edin

ms-identity-docs-code-dotnet deposunu kopyalayın.

git clone https://github.com/Azure-Samples/ms-identity-docs-code-dotnet.git

Çalışma klasörüne ms-identity-docs-code-dotnet/web-api gidin ve ./appsettings.json dosyasını açın, {APPLICATION_CLIENT_ID} ve {DIRECTORY_TENANT_ID}'ü bununla değiştirin:
- uygulamanın Genel Bakış bölmesindeki web API Uygulaması (istemci) kimliği Uygulama kayıtları.
- {DIRECTORY_TENANT_ID}, uygulamanın Genel Bakış bölmesindeki web API Dizini (kiracı) kimliğidirUygulama kayıtları.
Uygulamayı başlatmak için aşağıdaki komutu yürütebilirsiniz:
- .NET 6.0
- .NET 7.0
```
dotnet run
```
```
dotnet run --launch-profile https
```
Aşağıdakine benzer bir çıkış görüntülenir. Bağlantı noktası numarasını URL'ye https://localhost:{port} kaydedin.
```
... 
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: https://localhost:{port}
...
```

Web API'sini test edin

Öğretici: ASP.NET Core projesi oluşturma ve API'yi yapılandırma altında oluşturulan web API'sine, örneğin NewWebAPILocal, gidin ve klasörü açın.
Yeni bir terminal penceresi açın ve web API projesinin bulunduğu klasöre gidin.

.NET 6.0
.NET 7.0

Uygulamayı başlatmak için aşağıdaki komutu yürütebilirsiniz:
```
dotnet run
```

Aşağıdakine benzer bir çıkış görüntülenir. Bağlantı noktası numarasını URL'ye https://localhost:{port} kaydedin.
```
... 
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: https://localhost:{port}
...
```

Yetkilendirme kodu isteme

Yetkilendirme kodu akışı, istemcinin kullanıcıyı uç noktaya yönlendirmesiyle /authorize başlar. Bu istekte, istemci kullanıcıdan izin istemektedir Forecast.Read .

https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/authorize?client_id={web-app-calls-web-api_application_client_id}&response_type=code&redirect_uri=http://localhost&response_mode=query&scope=api://{web_API_application_client_id}/Forecast.Read

URL'yi kopyalayın, aşağıdaki parametreleri değiştirin ve tarayıcınıza yapıştırın:
- {tenant_id} , web uygulaması Dizin (kiracı) kimliğidir.
- {web-app-calls-web-api_application_client_id}, web uygulamasının (web-app-calls-web-api) Genel Bakış bölmesindeki Uygulama (istemci) kimliğidir.
- {web_API_application_client_id}, web API'sinin (NewWebAPI1) Genel Bakış bölmesindeki Uygulama (istemci) kimliğidir.
Uygulamaların kaydedildiği Microsoft Entra kiracısında kullanıcı olarak oturum açın. Gerekirse erişim isteklerine onay verme.
Tarayıcınız http://localhost/'e yönlendirilir. Tarayıcınızın gezinti çubuğuna bakın ve aşağıdaki adımlarda kullanmak üzere öğesini kopyalayın {authorization_code} . URL aşağıdaki kod parçacığının biçimini alır:
```
http://localhost/?code={authorization_code}
```

Erişim belirteci almak için yetkilendirme kodu ve cURL kullanma

cURL artık Microsoft kimlik platformu erişim belirteci istemek için kullanılabilir.

Aşağıdaki kod parçacığındaki cURL komutunu kopyalayın. Parantez içindeki değerleri terminalinize aşağıdaki parametrelerle değiştirin. Parantezleri kaldırdığınızdan emin olun:
- Bash
- Windows Komut İstemi
```
curl -X POST https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token \
-d 'client_id={web-app-calls-web-api_application_client_id}' \
-d 'api://{web_API_application_client_id}/Forecast.Read' \
-d 'code={authorization_code}&session_state={web-app-calls-web-api_application_client_id}' \
-d 'redirect_uri=http://localhost' \
-d 'grant_type=authorization_code' \
-d 'client_secret={client_secret}'
```
```
curl -X POST https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token ^
 -d "client_id={web-app-calls-web-api_application_client_id}" ^
 -d "api://{web_API_application_client_id}/Forecast.Read" ^
 -d "code={authorization_code}&session_state={web-app-calls-web-api_application_client_id}" ^
 -d "redirect_uri=http://localhost" ^
 -d "grant_type=authorization_code" ^
 -d "client_secret={client_secret}"
```
- {tenant_id} , web uygulaması Dizin (kiracı) kimliğidir.
- client_id={web-app-calls-web-api_application_client_id}ve session_state={web-app-calls-web-api_application_client_id} web uygulamasının (web-app-calls-web-api) Genel Bakış bölmesindeki Uygulama (istemci) kimliğidir.
- api://{web_API_application_client_id}/Forecast.Read, web API'sinin (NewWebAPI1) Genel Bakış bölmesindeki Uygulama (istemci) kimliğidir.
- code={authorization_code} , Yetkilendirme kodu isteme bölümünde alınan yetkilendirme kodudur. Bu, cURL aracının erişim belirteci istemesini sağlar.
- client_secret={client_secret} Değeri, İstemci gizli dizesi ekle bölümünde kaydedilen istemci gizli dizesidir.

cURL komutunu çalıştırın ve doğru girilirse aşağıdaki çıkışa benzer bir JSON yanıtı almanız gerekir:

{
   "token_type": "Bearer",
   "scope": "api://{web_API_application_client_id}/Forecast.Read",
   "expires_in": 3600,
   "ext_expires_in": 3600,
   "access_token": "{access_token}"
}

Erişim belirteci ile web API'si çağırma

Önceki cURL komutunu çalıştırarak Microsoft kimlik platformu bir erişim belirteci sağlamıştır. Alınan belirteç artık web API'sini çağırmak için http isteğinde taşıyıcı olarak kullanılabilir.

Web API'sini çağırmak için aşağıdaki cURL komutunu kopyalayın, parantez içinde aşağıdaki değerleri değiştirin ve terminalinize yapıştırın:
```
curl -X GET https://localhost:{port}/weatherforecast -ki \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer {access_token}"
```
- {access_token} önceki bölümdeki JSON çıkışından kaydedilen erişim belirteci değeri.
- {port} terminalde API'yi çalıştırırken kaydedilen web API'sinden bağlantı noktası numarası. https port numarası olduğundan emin olun.

İstekte geçerli bir erişim belirteci bulunduğunda, beklenen yanıt aşağıdaki çıkışa benzer bir çıkışla olur HTTP/2 200 :

HTTP/2 200
content-type: application/json; charset=utf-8
date: Day, DD Month YYYY HH:MM:SS
server: Kestrel
[{"date":"YYYY-MM-DDTHH:MM:SS","temperatureC":36,"summary":"Hot","temperatureF":96},{"date":"YYYY-MM-DDTHH:MM:SS","temperatureC":43,"summary":"Warm","temperatureF":109},{"date":"YYYY-MM-DDTHH:MM:SS","temperatureC":18,"summary":"Warm","temperatureF":64},{"date":"YYYY-MM-DDTHH:MM:SS","temperatureC":50,"summary":"Chilly","temperatureF":121},{"date":"YYYY-MM-DDTHH:MM:SS","temperatureC":3,"summary":"Bracing","temperatureF":37}]

Sonraki adımlar

OAuth 2.0 yetkilendirme kodu akışı ve uygulama türleri hakkında daha fazla bilgi için bkz:

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-03-08

Aracılığıyla paylaş

cURL ile ASP.NET Core web API'si çağırma

Önkoşullar

Microsoft kimlik platformu ile uygulama kaydetme

Web API'sini kaydetme

API'yi kullanıma sunma

Web uygulamasını kaydetme

İstemci gizli anahtarı ekle

Web API'sine erişime izin vermek için uygulama izinleri ekleme

Web API'sini test edin

Web API'sini test edin

Yetkilendirme kodu isteme

Erişim belirteci almak için yetkilendirme kodu ve cURL kullanma

Erişim belirteci ile web API'si çağırma

Sonraki adımlar

Geri Bildirim

Ek kaynaklar