Building Simple API Gateways with Ocelot and ASP.net Core
In the previous article, we've discovered what is an API gateway and the cool things that it brings. This article will demonstrate how to build a simple API gateway that routes incoming HTTP requests to the appropriate downstream services.
Articles in the Series
This article belongs to a series of articles that explains the importance of API gateways and how to build them using ASP.net Core. If you're interested to learn more about API gateways, it might be a good idea to spend some time reading the articles listed below.- Part 1: API Gateway in a Nutshell.
- Part 2: Building Simple API Gateways with Ocelot.
- Part 3: API Response Aggregation using Ocelot
- Part 4: API Defense using Rate Limiting and Ocelot.
- Part 5: Containerizing API Gateways
- Part 6: Containerizing API Gateways using Alpine Base Image
Introducing Ocelot
Download POC from GithubOcelot is an open source framework used for building .NET core API gateways, the project is aimed at people using .NET / .NET Core to build applications designed with microservices or SOA architectures. Ocelot provides an easy way to write a mapping file (ocelot.json) that could be used to route incoming HTTP requests to the appropriate downstream services.
See: GITHUB | Official Website
Battle Plan
In this guide, we'll build an API gateway for an e-commerce website. The e-commerce API will contain three sub-domains that we'll call "Authentication", "Catalog" and "Ledger" contexts. The gateway we'll build in this article will behave like a reverse proxy that routes incoming HTTP requests to the following downstream services:
- Authentication Service - Bounded context in-charge of managing all authentication related things like end-users and access to system.
- Catalog Service - Bounded context in-charge of managing all offered products.
- Ledger Service - Bounded context in-charge of managing all monetary-product transactions in the system.
Setup
If you want to skip the setup phase, you can download a bunch of bash scripts that I wrote to automate the generation of the four ASP.net core projects. Once you've downloaded the scripts, place them in a folder to group the output of the automation process and execute the script named 100_build-api-gateway.sh.
If you are a newbie in ASP.net Core or just keen to learn how the setup works, you can follow the steps below:
-
Generate 4 ASP.net Core Projects
-
Generate Solution and Attach Projects
-
Install Ocelot Nuget Package
-
Generate POCOs and Controllers
You can navigate to a sample project from GITHUB and copy the following models and controllers to your solutions:-
User Model
./Authentication/Models/User.cs Github Link -
User Controller
./Authentication/Controllers/UserController.cs Github Link -
Product Model
./Catalog/Models/Product.cs Github Link -
Project Controller
./Catalog/Controllers/ProductController.cs Github Link -
Transaction Model
./Ledger/Models/Transaction.cs Github Link -
Transaction Contorller
./Ledger/Controllers/TransactionController.cs Github Link
-
-
Configure Service Ports via launchSettings.json
In order to route HTTP requests properly, you have to ensure that each service will be able to run on the following local ports:- Authentication: http://localhost:52792/
- Catalog: http://localhost:52791
- Ledger: http://localhost:52790
- Gateway: http://localhost:52793
-
Start and test individual bounded context services
Test the solutions by running each of them and issuing a GET request against the following URLS:- Authentication: http://localhost:52792/api/user
- Catalog: http://localhost:52791/api/product/
- Ledger: http://localhost:52790/api/transaction
Configuring Ocelot
Now lets focus on the most important detail which is configuring Ocelot. The first thing that we have to do is configure the ocelot.json file and add the code below. Note that the BaseUrl is required by Ocelot for it to be aware of the URL it is running in order to perform a header find & replace for certain administrative configurations.
Navigate to the Program.cs file of the Gateway project and add the following configurations on the web host builder method. The code below will setup all the middlewares required by ocelot to function.
Setting up your Routes
Now that everything we need in the gateway side is configured, its time to setup routes using the ocelot.json file. Update your ocelot.json file by updating the re-routes section. The code above setups up the mappings dictionary of (see below) your application gateway to the downstream services.
- Gateway to Authentication
- Gateway to Catalog
- Gateway to Ledger
Testing the routes out
To test the routes, start all projects and navigate to each link listed below.
- User Endpoint http://localhost:52793/api/user
- Products Endpoint http://localhost:52793/api/product
- Transaction Endpoint http://localhost:52793/api/transaction
Conclusion
In this article, we've learned how to perform basic re-routing of HTTP requests from a gateway to downstream services using Ocelot. Please do note that the article only explained basic re-routing and the power of API gateways starts to shine with request aggregation which is the subject of the next article.
Related Articles
- Part 1: API Gateway in a Nutshell.
- Part 2: Building Simple API Gateways with Ocelot.
- Part 3: API Response Aggregation using Ocelot
- Part 4: API Defense using Rate Limiting and Ocelot.
- Part 5: Containerizing API Gateways
- Part 6: Containerizing API Gateways using Alpine Base Image
- 10 Steps to Setup and Containerize an Express Server
- Microservices: Picking the .NET Framework for your containerized applications.
adana escort - adıyaman escort - afyon escort - aksaray escort - antalya escort - aydın escort - balıkesir escort - batman escort - bitlis escort - burdur escort - bursa escort - diyarbakır escort - edirne escort - erzurum escort - eskişehir escort - eskişehir escort - eskişehir escort - eskişehir escort - gaziantep escort - gebze escort - giresun escort - hatay escort - ısparta escort - karabük escort - kastamonu escort - kayseri escort - kilis escort - kocaeli escort - konya escort - kütahya escort - malatya escort - manisa escort - maraş escort - mardin escort - mersin escort - muğla escort - niğde escort - ordu escort - osmaniye escort - sakarya escort - samsun escort - siirt escort - sincan escort - tekirdağ escort - tokat escort - uşak escort - van escort - yalova escort - yozgat escort - urfa escort - zonguldak escort
ReplyDeleteno deposit bonus forex 2021 - takipçi satın al - takipçi satın al - takipçi satın al - tiktok takipçi satın al - instagram beğeni satın al - instagram beğeni satın al - google haritalara yer ekleme - btcturk - tiktok izlenme satın al - sms onay - izlenme-satin-al.com/youtube - google haritalara yer ekleme - no deposit bonus forex 2021 - tiktok jeton hilesi - tiktok beğeni satın al - binance - takipçi satın al - uc satın al - finanspedia.com - sms onay - sms onay - tiktok takipçi satın al - tiktok beğeni satın al - twitter takipçi satın al - trend topic satın al - youtube abone satın al - instagram beğeni satın al - tiktok beğeni satın al - twitter takipçi satın al - trend topic satın al - youtube abone satın al - instagram beğeni satın al - tiktok takipçi satın al - tiktok beğeni satın al - twitter takipçi satın al - trend topic satın al - youtube abone satın al - instagram beğeni satın al - perde modelleri - instagram takipçi satın al - instagram takipçi satın al
ReplyDeleteinstagram takipçi satın al
ReplyDeleteinstagram takipçi satın al
takipçi satın al
instagram takipçi satın al
instagram takipçi satın al
takipçi satın al
instagram takipçi satın al
aşk kitapları
tiktok takipçi satın al
instagram beğeni satın al
youtube abone satın al
twitter takipçi satın al
tiktok beğeni satın al
tiktok izlenme satın al
twitter takipçi satın al
tiktok takipçi satın al
youtube abone satın al
tiktok beğeni satın al
instagram beğeni satın al
trend topic satın al
trend topic satın al
youtube abone satın al
beğeni satın al
tiktok izlenme satın al
sms onay
youtube izlenme satın al
tiktok beğeni satın al
sms onay
sms onay
perde modelleri
instagram takipçi satın al
takipçi satın al
tiktok jeton hilesi
pubg uc satın al
sultanbet
marsbahis
betboo
betboo
betboo
kayseri escort - hatay escort - kayseri escort
ReplyDeleteinstagram takipçi satın al
ReplyDeleteucuz takipçi
takipçi satın al
https://takipcikenti.com
https://ucsatinal.org
instagram takipçi satın al
https://perdemodelleri.org
https://yazanadam.com
instagram takipçi satın al
balon perdeler
petek üstü perde
mutfak tül modelleri
kısa perde modelleri
fon perde modelleri
tül perde modelleri
https://atakanmedya.com
https://fatihmedya.com
https://smmpaketleri.com
https://takipcialdim.com
https://yazanadam.com
yasaklı sitelere giriş
aşk kitapları
yabancı şarkılar
sigorta sorgula
https://cozumlec.com
word indir ücretsiz
tiktok jeton hilesi
rastgele görüntülü sohbet
erkek spor ayakkabı
fitness moves
gym workouts
https://marsbahiscasino.org
http://4mcafee.com
http://paydayloansonlineare.com
takipçi satın al
ReplyDeletetakipçi satın al
takipçi satın al
Ah, there is a good discussion about this paragraph on this website at this place, I read all that, so now I am commenting here too... Qualified travelers can get a Turkey visa by filling an online fill visa application to Turkey can do.
ReplyDeleteI think you should make a video how to build it and share such video on youtube. If you use this site https://soclikes.com you can promote your video faster
ReplyDeleteVery informative. I advice you to post this article as a video-review on Youtube so that many interested people can see it. And you can always use the services of https://viplikes.net/buy-youtube-subscribers to increase their number.
ReplyDeleteThanks for sharing excellent information.keep sharing such useful information..You can apply Indian business visa application through Online indian evisa website.
ReplyDeleteVery nice post, I definitely love this website, keep up the good work.. yes. Azerbaijan visa for US citizens can be acquired in a breeze with the convenience of online Azerbaijan Visa application processes. The Azerbaijan government has launched a new online visa system, wherein you can fill an application and receive your Azerbaijan visa entirely online .
ReplyDeleteDigital commerce, also known as e-commerce , is indeed a business concept that allows businesses and individuals to buy and sell goods through the Internet. The growth of online developers in India has been fueled by advancements in the IT industry and increased consumer understanding of the Internet.
ReplyDeletePPC company in India
PPC Company in USA
Thanks for this post. Foreign travelers who wish to apply for Azerbaijan visa must check the requirements for azerbaijan visa before filling the application.
ReplyDeleteHello sir, Hope your evening is going well. Do you need an evisa to India? You can find more information about e visa to India on our website about India e visa.
ReplyDeleteseo fiyatları
ReplyDeletesaç ekimi
dedektör
instagram takipçi satın al
ankara evden eve nakliyat
fantezi iç giyim
sosyal medya yönetimi
mobil ödeme bozdurma
kripto para nasıl alınır
Hello friends, Indian visa for US citizens, Indian e-Visa is issued for USA citizens under the following 5 categories. More info about Indian visas you can read through our website.
ReplyDeleteperde modelleri
ReplyDeletesms onay
mobil ödeme bozdurma
nft nasıl alınır
ANKARA EVDEN EVE NAKLİYAT
Trafik Sigortası
dedektor
KURMA WEB SİTESİ
Aşk Romanları
شركة عزل اسطح بالجبيل
ReplyDeleteشركة عزل اسطح بالدمام
We sincerely appreciate your remarkable post! Your insights have captivated our attention, Should you find yourself in need of Tombstones, monuments, or natural stone for virtually any purpose, we take great pleasure in offering our exceptional selection at wholesale prices!
ReplyDelete