<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Serhat Yücel on Medium]]></title>
        <description><![CDATA[Stories by Serhat Yücel on Medium]]></description>
        <link>https://medium.com/@serhat.yucel?source=rss-19a763b2aa3------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*99DVTW-W6AqrGq37ogwVGg.jpeg</url>
            <title>Stories by Serhat Yücel on Medium</title>
            <link>https://medium.com/@serhat.yucel?source=rss-19a763b2aa3------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 15:39:02 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@serhat.yucel/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[MCP Gateway Nedir?]]></title>
            <link>https://medium.com/ibtech/mcp-gateway-nedir-4ace6dbdad2b?source=rss-19a763b2aa3------2</link>
            <guid isPermaLink="false">https://medium.com/p/4ace6dbdad2b</guid>
            <category><![CDATA[mcp-gateway]]></category>
            <category><![CDATA[mcps]]></category>
            <category><![CDATA[mcp-server]]></category>
            <dc:creator><![CDATA[Serhat Yücel]]></dc:creator>
            <pubDate>Fri, 29 Aug 2025 10:40:41 GMT</pubDate>
            <atom:updated>2025-08-29T10:46:59.172Z</atom:updated>
            <content:encoded><![CDATA[<p>Bu yazının konusu; MCP nedir, neden ihtiyaç duyulmuştur gibi konulardan oluşmayacak. Yani bu kavramlarını bildiğinizi varsayarak yazıma devam edeceğim. Eğer bilmiyorsanız alttaki linke göz atabilirsiniz:</p><p><a href="https://modelcontextprotocol.io/docs/getting-started/intro">What is the Model Context Protocol (MCP)? - Model Context Protocol</a></p><h4>MCP Gateway’e neden ihtiyaç var?</h4><p>İhtiyaçlarınız dahilinde birden çok MCP server yazmanız gerekebilir. Özellikle büyük çaplı şirketlerde <strong>domain driven development</strong> ilkesi altında her domain kendi MCP server(lar)ını oluşturmak isteyebilir. Fakat hepsinin belirli bir standarta ve belli başlı özelliklere sahip olması gerekir.</p><ul><li>Gelen/giden isteklerin loglanabilmesi.</li><li>Client kimliğinin doğrulanabilmesi.</li><li>Adil kaynak tüketimi için rate limit yapılabilmesi.</li><li>Tek bağlantı noktası ile proxylemenin gateway seviyesinde yapılabilmesi.</li></ul><p>Yani aslında API dünyasındaki benzer ihtiyaçların MCP dünyasında da karşımıza çıktığını görüyoruz. Her MCP server için <strong>authorization</strong>, <strong>logging </strong>ve <strong>rate limiting </strong>katmanlarının tekrar tekrar yazılması maliyeti arttıracağından, tüm bu ihtiyaçları tek bir çatıda, bir defa yapmak için <strong>MCP gateway</strong> çözümüne ihtiyaç duyuyoruz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/521/1*_uzuN9Nz5d4aPlyd_FRXLQ.png" /></figure><p>MCP gateway’de iki farklı yaklaşım tercih edilebilir:</p><ul><li>N tane MCP server’ı birleştirip tek MCP server gibi göstermek.</li><li><strong>Context path</strong> temelli kırılım yaratarak logging, authorization ve rate limiting özelliklerini ortak tutup serverları ayrı kullanmak.</li></ul><p>Bu her iki yaklaşımın da kendine has artıları ve eksileri vardır. Kullanılan client uygulama özelliklerine göre uyumlanmak gerekebilir. Özellikle tool sayısının yüksek olması bazı MCP client uygulamalarında limite takılmanıza sebep olabilir.</p><h4>MCP Registry nedir?</h4><p>Az önce bahsetmiştim, ihtiyaçlarınız çerçevesinde birden çok MCP Serverınız olabilir. MCP Gateway uygulamanıza eklenen MCP Serverları bir endpoint yardımı vasıtası ile dışarıya açabilirsiniz. MCP’nin genel işlevinden bahseden, sahipliğini gösteren, tool bilgisini barındıran layer’a da MCP Registry diyoruz. Bu sayede, şirket bünyesinde kullanılacak MCP serverların ne iş yaptığına, kaç tane MCP server olduğuna ulaşabiliyorsunuz.</p><h4>Developerlar için notlar</h4><p>Biz IBTECH bünyesinde MCP Gateway uygulamamızı kendimiz yazdık. Şuan <strong>microsoft’un </strong>bir çözümü olduğunu biliyorum bir de opensource bazlı projeler var. Tercihlerinizi bunlardan birinde kullanabilirsiniz. Kendi uygulamasını yazmak isteyen developer arkadaşlar için birkaç nacizane öneride bulunmak istiyorum.</p><ul><li>MCP Serverın, gateway uygulamanıza downstream server sent events üzerinden cevap verdiğini unutmayın. Yani MCP servera yapılan her tool call farklı bir request context ile oluşurken, MCP serverın verdiği cevap SSE bağlantısının oluştuğu ilk context üzerinden gönderilir. Loglama için bir session id implemantasyonu veya request/response <strong>header forwarding</strong> kullanabilirsiniz.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/768/1*Wxv3qBLWLHpSY837xFu6ew.png" /></figure><ul><li>Loglama yaparken downstreamde bulunan data bufferların leak olması ihtimaline karşı, release etmeyi unutmayın.<br><a href="https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/core/io/buffer/DataBufferUtils.html">https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/core/io/buffer/DataBufferUtils.html</a></li><li>SYNC programlamayı bir kenara bırakıp, varsayılan olarak ASYNC çalışmaya müsait frameworklere yönelin. Örneğin <strong>Spring WebFlux MVC</strong> temelini kullanan bir MCP server oluşturun. Non-blocking özelliği sayesinde throughput’u en yükseğe çıkarmaya çalışın.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/734/1*K0k9-1MXwy8g-T6WktIHZg.png" /></figure><p>Evet genel hatları ile MCP Gateway’in ne olduğundan, hangi amaçla kullanıldığından bahsetmiş olduk. Özellikle developer’a notlar kısmının faydalı olacağını düşünüyorum. Vakit ayırıp okuduğunuz için teşekkür ederim.</p><p>İyi günler</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4ace6dbdad2b" width="1" height="1" alt=""><hr><p><a href="https://medium.com/ibtech/mcp-gateway-nedir-4ace6dbdad2b">MCP Gateway Nedir?</a> was originally published in <a href="https://medium.com/ibtech">IBTech</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Spring WebFlux ile JWT Authentication]]></title>
            <link>https://medium.com/ibtech/spring-webflux-ile-jwt-authentication-9441b3c82753?source=rss-19a763b2aa3------2</link>
            <guid isPermaLink="false">https://medium.com/p/9441b3c82753</guid>
            <category><![CDATA[java]]></category>
            <category><![CDATA[jwt]]></category>
            <category><![CDATA[spring-webflux]]></category>
            <category><![CDATA[spring-security]]></category>
            <dc:creator><![CDATA[Serhat Yücel]]></dc:creator>
            <pubDate>Fri, 29 Mar 2024 08:56:02 GMT</pubDate>
            <atom:updated>2024-03-29T12:17:42.670Z</atom:updated>
            <content:encoded><![CDATA[<p>Spring WebFlux’ın saniyede işleyebildiği işlem kapasitesine (throughput), thread’i kilitlemeden diğer işlemlere devam edebilmesine (non-blocking) ve gerçek zamanlı olarak veri değişimlerine tepki verebilmesine (reactive) siz de benim gibi hayran kaldıysanız ve bir sonraki projenizi webflux ile geliştirmeye karar verdiyseniz, yüksek ihtimalle ilk yapacağınız proje CRUD API projesi olacak.</p><p>İlerleyen zamanlarda API’yi biraz daha geliştirip, bazı endpointleri korumak isteyeceksiniz. Örneğin sadece Admin yetkisine sahip kullanıcıların erişebileceği endpointleriniz olacak ve bunu diğer kullanıcıların erişimine kapatmanız gerekecek.</p><p>İşte tüm bu ihtiyaçları karşılayabilmek için iki önemli kavramı bilmemiz gerekiyor: <strong>Authorization </strong>ve <strong>Authentication</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4bIiQMOZ3syB6DJm_Dk6pw.jpeg" /></figure><p><strong>Authentication</strong>: Kullanıcı kimdir? Kullanıcı adı ve parolası eşleşiyor mu, diye kimlik kontrolünde bulunur. Kimliğin doğrulanması ile beraber bir çıktı üretir. Bu çıktı zaman zaman bir session cookiesi olabilirken, bazense bir JWT olabilir.</p><p><strong>Authorization</strong>: Kullanıcı nerelere erişebilir? Kullanıcının yetkisi nedir? Bu yetkiyle neler yapabilir? Sorularına cevap arar.</p><p>Çok fazla detaya inmek istemiyorum, dolayısıyla yukarıda belirttiğim kavramlara aşina olmadığınız varsa şiddetle araştırmanızı öneriyorum. Bundan sonrası işin uygulama kısmı olacak.</p><p><strong>WebFlux </strong>projemizde, <strong>Spring Security</strong> kullanarak <strong>JWT </strong>ile authorization ve authentication işlemleri yapacağız. <strong>MongoDB</strong>’de kayıtlı bir kullanıcımız olacak, login olduğunda ona bir JWT üreteceğiz ve izin verdiğimiz endpointlere yetkisi dahilinde erişmesini sağlayacağız.</p><p>İşe <strong>User </strong>entitysini oluşturarak başlayalım, kısacası kullanıcıyı hangi formatta veritabanına kaydedeceğimize karar verelim:</p><pre>@Data<br>@Document(collection = &quot;users&quot;)<br>@Builder<br>@NoArgsConstructor<br>@AllArgsConstructor<br>public class User {<br>    @Id<br>    private ObjectId id;<br>    private String mail;<br>    private String password;<br>    private String role;<br>    private boolean isDeleted;<br>    private Date createdAt;<br><br>    public Collection&lt;? extends GrantedAuthority&gt; getAuthorities() {<br>        List&lt;SimpleGrantedAuthority&gt; authorities = new ArrayList&lt;&gt;();<br>        authorities.add(new SimpleGrantedAuthority(&quot;ROLE_&quot; + this.role));<br>        return authorities;<br>    }<br><br>}</pre><p>User login olurken, mail adresini ve şifresi kontrol edilecek. Yani “<strong>mail</strong>” ile arama yapmaya ihtiyacımız var. O halde <strong>UserRepository </strong>sınıfımızı oluşturalım.</p><pre>public interface UserRepository extends ReactiveMongoRepository&lt;User, String&gt; {<br><br>    Mono&lt;User&gt; findByMail(String mail);<br><br>}</pre><p>Kullanıcı oluşturma (<strong>create()</strong>) ve oturum açma (<strong>login()</strong>) gibi işlemler için bir <strong>UserService </strong>oluşturalım. Kullanıcının şifresini veritabanında şifreli bir şekilde tutalım bunun için <strong>BCryptPasswordEncoder </strong>kullanacağız:</p><pre>@Service<br>@AllArgsConstructor<br>public class UserService {<br><br>    private final UserRepository repository;<br><br>    public Mono&lt;User&gt; create(User user) {<br><br>        return this.findByMail(user.getMail())<br>                .flatMap(foundUser -&gt; {<br>                    if(foundUser.getId() != null) {<br>                        return Mono.error(new RuntimeException(&quot;Bu mail adresi zaten kayıtlı&quot;));<br>                    }<br>                    return repository.save(User.builder()<br>                            .mail(user.getMail())<br>                            .password(passwordEncoder().encode(user.getPassword()))<br>                            .isDeleted(false)<br>                            .createdAt(new Date())<br>                            .role(&quot;USER&quot;).build());<br>                });<br>    }<br><br>    public Mono&lt;User&gt; findByMail(String mail) {<br>        //Database&#39;i mail bilgisi ile sorgula. Eğer user bulunamazsa bir user dön.<br>        return repository.findByMail(mail)<br>                .defaultIfEmpty(User.builder().build());<br>    }<br><br>    public Mono&lt;String&gt; login(String mail, String password) {<br>        return this.findByMail(mail).flatMap(foundUser -&gt; {<br>            if(foundUser.getId() == null) {<br>                return Mono.error(new RuntimeException(&quot;User bulunamadı.&quot;));<br>            }<br><br>            if(foundUser.isDeleted()){<br>                return Mono.error(new RuntimeException(&quot;User silinmiş.&quot;));<br>            }<br><br>            if(!passwordEncoder().matches(password, foundUser.getPassword())){<br>                return Mono.error(new RuntimeException(&quot;Şifre doğru değil.&quot;));<br>            }<br><br>            return Mono.just(foundUser);<br>        }).flatMap(foundUser -&gt; JWTUtil.createJwt(foundUser.getMail()));<br>    }<br><br>    private PasswordEncoder passwordEncoder() {<br>        return new BCryptPasswordEncoder();<br>    }<br><br>}</pre><p>Kullanıcı login olurken onu bazı kontrollerden geçiriyoruz. Normal şartlar altında “<em>User bulunamadı, şifresi yanlış, silinmiş</em>” gibi bilgileri kullanıcıya dönmek <strong>doğru bir davranış değildir</strong>. Bunun yerine genel bir hata olarak http statüsünü “<strong>401</strong>” dönmek kimlik doğrulamanın başarısız olduğunu göstermek adına yeterli olacaktır. Aksi takdirde gizlilik konusu ortadan kalkacağı gibi, <strong>bruteforce </strong>gibi saldırı tekniklerine de zemin hazırlamış olursunuz. Ben eğitim amaçlı olarak, size nasıl doğrulamalar yaptığımı gösterebilmek adına exceptionları farklılaştırmak istedim.</p><p>Login metodunda gördüğünüz kullanıcı kontrolleri tamamlandıktan sonra bir JWT üretiyoruz. Bunun için bir tane <strong>JWTUtil </strong>sınıfı yazabiliriz. Yazmışken ileride lazım olacak JWT’yi doğrulayıp içerisinden subject bilgisini alan bir fonksiyon da ekleyelim.</p><pre>public class JWTUtil {<br><br>    private static final String SECRET_KEY = &quot;JSOeFwdiebXNtLkuhv4w99ONRs8bLegFhnz0386hB2EDl8dgqCvYl2DmH29e0z3llUPLvLfP8jCQgrmhFILQFqUrNmwqt0j&quot;;<br>    private static final Algorithm algorithm = Algorithm.HMAC256(SECRET_KEY);<br>    private static final JWTVerifier verifier = JWT.require(algorithm).build();<br>    private static final Long expirationTime = 3600000L; // 3600 saniye (1 saat)<br><br>    public static Mono&lt;String&gt; createJwt(String subject) {<br>        return Mono.fromCallable(() -&gt; {<br><br>            return JWT.create()<br>                    .withIssuer(&quot;Serhat&quot;)<br>                    .withSubject(subject)<br>                    .withIssuedAt(new Date())<br>                    .withExpiresAt(new Date(System.currentTimeMillis() + expirationTime))<br>                    .sign(Algorithm.HMAC256(SECRET_KEY));<br><br>        });<br>    }<br>    public static Mono&lt;String&gt; validateJwt(String jwt) {<br>        return Mono.fromCallable(() -&gt; {<br>            try {<br>                DecodedJWT decodedJWT = verifier.verify(jwt);<br>                return decodedJWT.getSubject();<br>            }catch (Exception e) {<br>                //Süresi geçmiş olabilir, doğru bir jwt olmayabilir.<br>                throw new RuntimeException(&quot;JWT doğrulanamadı.&quot;);<br>            }<br>        });<br>    }<br>}</pre><p>Entity hazır, repository hazır, service hazır geriye istekleri karşılayacak bir controller kalıyor. <strong>UserController </strong>sınıfı:</p><p><strong>POST /users</strong> =&gt; Yeni bir kullanıcı kaydı yapacak.<br><strong>POST /users/login</strong> =&gt; Mail ve şifre ile user Authentication yaparak, bir JWT dönecek.</p><pre>@RestController<br>@RequiredArgsConstructor<br>public class UserController {<br>    <br>    private final UserService userService;<br>    private final UserRepository userRepository;<br><br>    @PostMapping(&quot;/users&quot;)<br>    public Mono&lt;User&gt; createUser(@RequestBody Mono&lt;User&gt; user) {<br>        return user.flatMap(userService::create);<br>    }<br><br>    @PostMapping(&quot;/users/login&quot;)<br>    public Mono&lt;String&gt; login(@RequestBody Mono&lt;User&gt; user) {<br>        return user.flatMap(u -&gt; userService.login(u.getMail(), u.getPassword()));<br>    }<br>}</pre><figure><img alt="Kullanıcı oluşturma isteği" src="https://cdn-images-1.medium.com/max/1024/1*DBu4IlxcbPlgVg_jLr7EtA.png" /><figcaption>Kullanıcı oluşturma isteği</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*r3IFr96aak1HU3w09sV-eg.png" /><figcaption>Mongo’ya başarıyla yazabildik</figcaption></figure><p>İlk kullanıcımızı başarıyla oluşturduk. Şimdi login olmayı deneyelim:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*n-Tkd6OdvFoMkREbN98nWw.png" /></figure><p>JWT’yi decode edip bir inceleyelim (jwt.io sitesini kullanabilirsiniz):</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ViJFdz6nqFJwgjl8Mz4LLA.png" /></figure><p>Her şey güzel gözüküyor. Şimdi işin içerisine Spring Security’i dahil edeceğiz ama öncesinde bazı önemli kavramları konuşmamız gerekecek. Sırayla basit bir şekilde çok da detaya inmeden mantığı anlamaya çalışalım.</p><h3>AuthenticationWebFilter</h3><p>Spring Security, exchange server’a gelen istekleri, filtreleme özelliğine sahip. Yani aslında temel olarak, her istek geldiğinde o istek üzerinde bazı değişikler ve doğrulamalar yapmanıza olanak sağlayacak bir yapı sunar. Bunlardan bir tanesi Spring Security projesi içerisinde default olarak bulunan AuthenticationWebFilter sınıfıdır. Bu sınıfa yardımcı diğer sınıfları setleyerek, sunucuya düşen istekleri yetkilendirebileceğiz. Yardımcı sınıflarla devam edelim.</p><h3><strong>AuthenticationConverter</strong></h3><p>Spring Security’de tek bir auth yöntemi yoktur. Esnek yapısı, duruma göre basic auth duruma göre oauth2.0 vb doğrulama yöntemleri kullanmanıza olanak sağlar. Ama temelinde hepsinin belli başlı bir sınıfa indirgenmesi gerekir ki auth akışlarını işletebilsin. Bu sınıf tam olarak bu yüzden var. Ben bu yazıda sizlere JWT ile bu işi nasıl yapabileceğinizi anlatıyorum. Dolayısıyla bazı endpointlere erişmek için, istekte bulunan Auhorization headerındaki JWT’yi kullanmam gerekecek. Converter da istekteki JWT’yi yakalayıp bir <strong>Authentication </strong>objesine dönüştürmek için var. O halde hemen bir converter yazalım:</p><pre>@Component<br>public class BearerAuthenticationConverter implements ServerAuthenticationConverter {<br>    @Override<br>    public Mono&lt;Authentication&gt; convert(ServerWebExchange exchange) {<br>        return Mono.justOrEmpty(exchange.getRequest().getHeaders().getFirst(HttpHeaders.AUTHORIZATION))<br>                .filter(headerValue -&gt; headerValue.startsWith(&quot;Bearer &quot;))<br>                .map(headerValue -&gt; headerValue.split(&quot; &quot;)[1])<br>                .map(BearerAuthentication::new);<br>    }<br>}</pre><p>İstekten <strong>Authorization </strong>headerını aldık, JWT’nin başındaki “<strong>Bearer </strong>“ prefixini sildik ve elimizdeki JWT’yi <strong>BearerAuthentication </strong>objesine pasladık. O halde onu oluşturalım:</p><pre>public class BearerAuthentication extends AbstractAuthenticationToken {<br><br>    final private String token;<br><br>    public BearerAuthentication(String token) {<br>        super(AuthorityUtils.NO_AUTHORITIES);<br>        this.token = token;<br>    }<br><br>    public String getToken() {<br>        return this.token;<br>    }<br><br>    @Override<br>    public Object getCredentials() {<br>        return null;<br>    }<br><br>    @Override<br>    public Object getPrincipal() {<br>        return null;<br>    }<br>}</pre><p>BearerAuthentication temelinde bir Authentication objesi olmalı. Bize şimdilik sadece JWT’yi taşımak için gerekiyor o yüzden super classtan gelen metodları doldurmamıza gerek yok.</p><h3>AuthenticationManager</h3><p>İstekten gelen JWT’yi doğrulamaya hazırız. JWT doğru ise içerisindeki subject bilgisiyle, işlemi yapan User’ı yetkilendirebiliriz. AuthenticationManager bu yüzden doğrulama ile ilgilenen sınıftır diyebiliriz basitçe. Converterdan aldığı Authentication objesini kullanarak, belli başlar doğrulamalar yapar ve yetkili kullanıcıyı SecurityContextHolder’a setler. Bu da aslında controller’da yetkili kullanıcı bilgisine hızlıca ulaşmamıza olanak sağlar. O halde yazalım:</p><pre>@Component<br>@RequiredArgsConstructor<br>public class BearerAuthenticationManager implements ReactiveAuthenticationManager {<br><br>    private final UserService userService;<br><br>    @Override<br>    public Mono&lt;Authentication&gt; authenticate(Authentication authentication) {<br>        BearerAuthentication auth =  (BearerAuthentication) authentication;<br>        String token = auth.getToken();<br><br>        return JWTUtil.validateJwt(token)<br>                .flatMap(userService::findByMail)<br>                .flatMap(user -&gt; {<br><br>                    if(user.getId() == null) {<br>                        return Mono.error(new RuntimeException(&quot;Kullanıcı bulunamadı.&quot;));<br>                    }<br><br>                    return Mono.just(new UsernamePasswordAuthenticationToken(user,user,user.getAuthorities()));<br>                });<br>    }<br>}</pre><p>Manager, converterdan gelen Authentication objesini aldı ve JWTUtil’i kullanarak geçerli bir JWT olup olmadığını kontrol etti. Eğer geçerliyse JWT içerisindeki subject bilgisini yani mail adresini kullanarak bir sorgulama yaptı. Buradaki kontrolleri çoğaltmak mümkün. Kullanıcı aktif mi değil mi gibi ekstra kontroller yapılabilir. Kontroller başarılı ise <strong>UsernamePasswordAuthenticationToken </strong>objesine kendi database’imizde bulunan User objesini setledik. Artık controllerda doğrulanmış olan User’ı kullanmaya hazırız.</p><p>Her şey çok güzel, Converter’ı anladık, Manager’i anladık şimdi ilk kavram olan AuthenticationWebFilter kullanabilmek için bir güvenlik konfigürasyon sınıfı oluşturalım.</p><pre>@Configuration<br>@EnableWebFluxSecurity<br>public class SecurityConfig {<br><br>    @Bean<br>    public SecurityWebFilterChain springSecurityFilterChain(ServerHttpSecurity http, BearerAuthenticationManager authManager, BearerAuthenticationConverter authConverter) {<br>        AuthenticationWebFilter authFilter = new AuthenticationWebFilter(authManager);<br>        authFilter.setServerAuthenticationConverter(authConverter);<br><br>        return http<br>                .csrf(ServerHttpSecurity.CsrfSpec::disable)<br>                .authorizeExchange(exchanges -&gt; exchanges<br>                        .pathMatchers(&quot;/users&quot;,&quot;/users/login&quot;).permitAll()<br>                        .pathMatchers(&quot;/users/admin&quot;).hasRole(&quot;ADMIN&quot;)<br>                        .pathMatchers(&quot;/users/protected&quot;).hasRole(&quot;USER&quot;)<br>                        .anyExchange().authenticated()<br>                )<br>                .addFilterAt(authFilter, SecurityWebFiltersOrder.AUTHENTICATION)<br>                .build();<br>    }<br>}</pre><p>Yukarıda bahsettiğim gibi AuthenticationWebFilter zaten Spring Security içerisinde var. Biz ek olarak converteri ve manageri yazdık. Sonrasında <strong>authorizeExchange </strong>kullanarak endpointlerimize kimlerin erişebileceğine karar verdik.</p><p><strong>/users</strong> ve <strong>/users/login</strong> herkese açık olarak çalışan endpointlerimiz. (yazının başında zaten eklediğimiz endpointler)<br><strong>/users/admin </strong>=&gt; Sadece ADMIN rolüne sahip kullanıcıların erişebileceği bir endpoint<br><strong>users/protected</strong> =&gt; Sadece USER rolüne sahip kullanıcıların erişimine açık.</p><p>O Halde gidip <strong>UserController </strong>sınıfımıza bu yeni endpointlerimizi de ekleyelim:</p><pre>@RestController<br>@RequiredArgsConstructor<br>public class UserController {<br><br>    private final UserService userService;<br>    private final UserRepository userRepository;<br><br>    @PostMapping(&quot;/users&quot;)<br>    public Mono&lt;User&gt; createUser(@RequestBody Mono&lt;User&gt; user) {<br>        return user.flatMap(userService::create);<br>    }<br><br>    @PostMapping(&quot;/users/login&quot;)<br>    public Mono&lt;String&gt; login(@RequestBody Mono&lt;User&gt; user) {<br>        return user.flatMap(u -&gt; userService.login(u.getMail(), u.getPassword()));<br>    }<br>    @GetMapping(&quot;users/protected&quot;)<br>    public Mono&lt;User&gt; dummy(@AuthenticationPrincipal User user) {<br>        return Mono.just(user);<br>    }<br><br>    @GetMapping(&quot;users/admin&quot;)<br>    public Mono&lt;User&gt; dummyAdmin(@AuthenticationPrincipal User user) {<br>        return Mono.just(user);<br>    }<br>}</pre><p>Controllerda Authenticated userımı alabilmek için <strong>@AuthenticationPrincipal</strong> annotasyonunu kullandım. Authentication managerda, <strong>UsernamePasswordAuthenticationToken</strong> objesinin princal propertysine setlediğimiz objeye bu şekilde erişebiliyoruz.</p><p>Şimdi herhangi bir Authentication headerı beslemeden /users/protected endpointimizi test edelim:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2xhaZjaR6Y_MkPciH9xsaQ.png" /><figcaption>Status: 401 Unauthorized</figcaption></figure><p>Rolü <strong>USER </strong>olan kullanıcının tokeni ile <strong>/users/admin</strong> endpointini test edelim:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*iomTwqqFGak6lfseqkDufg.png" /><figcaption>Status: 403 Forbidden</figcaption></figure><p>Görüldüğü üzere, endpointlerimizi başarıyla koruyabildik.</p><h3>Neleri İyileştirebilirim?</h3><p>Esas soru bu aslında. Bu yazıyı çok uzun olmaması açısından daha fazla ilerletemiyorum. Elbette her zaman farklı çözümler, sınıflar kullanılabilir, geliştirilebilir. Ama bundan sonra yapabileceğiniz şeyleri fikir olması açısından paylaşabilirim:</p><p><strong>1-</strong>Global bir error handler ve custom error sınıfı yazılarak, throw edilen hatalara göre bir response özelleştirilmesi yapılabilir.</p><p><strong>2-</strong>Ürettiğiniz JWT’leri bir veritabanına mutlaka kaydedin. Authorization gereken işlemlerde öncelikle requestte gelen JWT veritabanında kayıtlı mı diye kontrol edin. Bunun bize önemli güvenlik artıları olacaktır. Örneğin sosyal medya hesaplarında gördüğümüz “<strong>Tüm oturumları kapat</strong>” seçeneğini siz de uygulayabilir hale geleceksiniz. USER ile ilişkili tüm tokenları, veritabanından sildiğinizde tekrar oturum açması gerekecektir.</p><p><strong>3-</strong>OAUTH2.0 standartını araştırıp daha complex yetkilendirmeler yapabilirsiniz. Daha büyük projeler için AuthResource server kurarak tüm yetkilendirme işlemlerini onun üzerinden ilerletebilirsiniz.</p><p>Umarım faydalı bir yazı olmuştur, eksik gördüğünüz, yanlış olduğunu düşündüğünüz şeyler varsa mutlaka belirtin. Sektör artık inanılmaz hızlı ilerliyor ve her daim yeni yeni yöntemler çıkıyor. Bu şekilde ben de kendimi geliştirmiş olurum</p><p>Okuduğunuz için teşekkürler.</p><p>Github: <a href="https://github.com/serhatyucell/Webflux-jwt">https://github.com/serhatyucell/Webflux-jwt</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=9441b3c82753" width="1" height="1" alt=""><hr><p><a href="https://medium.com/ibtech/spring-webflux-ile-jwt-authentication-9441b3c82753">Spring WebFlux ile JWT Authentication</a> was originally published in <a href="https://medium.com/ibtech">IBTech</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Spring WebFlux Functional Endpoint için Validasyon ve Error Handling]]></title>
            <link>https://medium.com/ibtech/spring-webflux-functional-endpoint-validasyon-ve-error-handling-49a1b3071ed2?source=rss-19a763b2aa3------2</link>
            <guid isPermaLink="false">https://medium.com/p/49a1b3071ed2</guid>
            <category><![CDATA[spring-webflux]]></category>
            <category><![CDATA[java]]></category>
            <category><![CDATA[reactive-programming]]></category>
            <category><![CDATA[error-handling]]></category>
            <dc:creator><![CDATA[Serhat Yücel]]></dc:creator>
            <pubDate>Mon, 02 Oct 2023 22:30:46 GMT</pubDate>
            <atom:updated>2023-10-03T13:33:33.714Z</atom:updated>
            <content:encoded><![CDATA[<p>Spring Webflux kullanarak, functional endpointlerimiz üzerinden geçen requesti nasıl doğrularız? Bu makalede bu sorunun cevabını arayacağız.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/1*P-9ZOpHdOvXnCH9jXPughQ.jpeg" /></figure><p>Geleneksel Spring MVC framework’ünü daha önce kullanmış olanlar <strong>@ControlAdvice</strong>, <strong>@Valid</strong> ve Bean doğrulama anotasyonlarına (<strong>@NotBlank</strong>, <strong>@Size </strong>vb.) aşınadır elbet. RestController’da bu validasyon işini birkaç anotasyonla çözmek mümkün.</p><p>Gel gelelim ki reactive dünyada işler biraz daha karmaşık bir hal alıyor. Functional endpoint kullandığımız zaman RestController sınıflarımız olmadığı için Bean validasyonlarından da hızlı bir şekilde yararlanamıyoruz. Hadi o zaman biraz koda dalalım ve validasyon işlemini yapmaya çalışalım. Bir blog projesi kodluyor olalım ve ilk enpointimiz ile işe koyulalım.</p><pre>@Configuration<br>public class BlogRouter {<br><br>    @Bean<br>    public RouterFunction&lt;ServerResponse&gt; BlogRouter() {<br>        return RouterFunctions.route()<br>                .POST(&quot;blog&quot;, r -&gt; ServerResponse.ok().bodyValue(&quot;/blog POST isteği geldi.&quot;))<br>                .build();<br>    }<br>}</pre><p>“<strong>/blog</strong>” endpoitine POST isteği atıldığında bize “<strong>/blog POST isteği geldi.</strong>” yazısı dönen bir functional endpointimiz var artık.</p><p>/blog endpointine gelen POST isteğinin body’sini yakalamak için bir <strong>BlogRequest</strong> objesi yaratalım. title ve content isimli 2 tane prop yeterli olur. Hemen Jakarta anotasyonlarını kullanarak bu değerlerin null bırakılmamasını sağlayalım</p><pre>@Data<br>@AllArgsConstructor<br>@NoArgsConstructor<br>@Builder<br>public class BlogRequest {<br><br>    @NotBlank(message=&quot;Başlık boş bırakılamaz.&quot;)<br>    private String title;<br><br>    @NotBlank(message=&quot;İçerik boş bırakılamaz.&quot;)<br>    private String content;<br>}</pre><p>Request objemiz hazır, şimdi functional endpointimize gidip, request bodyi objemize çevirelim ve olduğu gibi kullanıcıya geri dönelim</p><pre>@Configuration<br>public class BlogRouter {<br><br>    @Bean<br>    public RouterFunction&lt;ServerResponse&gt; BlogRouter() {<br>        return RouterFunctions.route()<br>                .POST(&quot;blog&quot;, this::blogHandler)<br>                .build();<br>    }<br><br>    Mono&lt;ServerResponse&gt; blogHandler(ServerRequest request) {<br>        return request.bodyToMono(BlogRequest.class).flatMap(reqObject -&gt; {<br>            return ServerResponse.ok().bodyValue(reqObject);<br>        });<br>    }<br>}</pre><p>Şimdi bir tane Validator sınıfı yazalım ve request objemizde verdiğimiz anotasyonlara göre doğrulama yapmasını sağlayalım. Sonra bu validator sınıfımızı functional endpointimize dahil edelim.</p><pre>@Component<br>public class GlobalRequestValidator {<br>    @Autowired<br>    Validator validator;<br><br>    public &lt;T&gt; Mono&lt;T&gt; validateRequest(T requestObj) {<br><br>        //Request objesi null ise hata dön<br>        if (requestObj == null) {<br>            return Mono.error(new IllegalArgumentException());<br>        }<br><br>        //jakarta validasyonunu kullan<br>        Set&lt;ConstraintViolation&lt;T&gt;&gt; violatedRules = this.validator.validate(requestObj);<br>        <br>        //Herhangi bir hata yoksa request objesini dön varsa hata dön.<br>        return (violatedRules == null || violatedRules.isEmpty()) ? Mono.just(requestObj) : Mono.error(new ConstraintViolationException(violatedRules));<br>    }<br>}</pre><pre>@Configuration<br>public class BlogRouter {<br><br>    @Autowired<br>    GlobalRequestValidator reqValidator;<br><br>    @Bean<br>    public RouterFunction&lt;ServerResponse&gt; BlogRouter() {<br>        return RouterFunctions.route()<br>                .POST(&quot;blog&quot;, this::blogHandler)<br>                .build();<br>    }<br><br>    Mono&lt;ServerResponse&gt; blogHandler(ServerRequest request) {<br>        return request.bodyToMono(BlogRequest.class)<br>                .flatMap(this.reqValidator::validateRequest)<br>                .flatMap(reqObject -&gt; {<br>                    return ServerResponse.ok().bodyValue(reqObject);<br>                })<br>                .onErrorResume(e -&gt; {<br>                    return ServerResponse.badRequest().bodyValue(e.getMessage());<br>                });<br>    }<br>}</pre><p>Hadi functional endpointimizin neler yaptığını kısaca özetleyelim.</p><ol><li>İstek body’sini <strong>BlogRequest</strong> sınıfına uyarlamaya çalışıyor.</li><li><strong>GlobalRequestValidator</strong>, oluşan <strong>BlogRequest </strong>objesini anotasyonlarına göre doğruluyor.</li><li>Functional endpointimiz <strong>GlobalRequestValidator</strong> bir hata fırlatmışsa bunu yakalayıp, HTTP status Bad Request olacak şekilde cevap dönüyor.</li></ol><p>Bir deneme yapalım:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*6i17cT58TYQ-Kr2QsgS7tQ.png" /><figcaption>POST /blog</figcaption></figure><p>Sonuç başarılı ama işlemlerimiz olabildiğince basit. Döndüğümüz badRequest bile JSON değil. Yani gerçek dünyada yazılacak daha bir sürü satır kodumuz var ama dikkatinizi bir şeye çekmek isterim. Sizce her endpointin handleri içerisinde onErrorResume yakalamak, implementasyonunu yapmak kaliteli bir yol mu? İlerde fazlaca endpointimiz olduğunda işler daha da çığrından çıkacaktır. O zaman bir tane handleException hazırlayalım ve hata yakalamayı daha üst bir kısımda yapalım</p><pre>@Configuration<br>public class BlogRouter {<br><br>    @Autowired<br>    GlobalRequestValidator reqValidator;<br><br>    @Bean<br>    public RouterFunction&lt;ServerResponse&gt; BlogRouter() {<br>        return RouterFunctions.route()<br>                .POST(&quot;blog&quot;, this::blogHandler)<br>                .onError(ConstraintViolationException.class, this::handleException)<br>                .build();<br>    }<br><br>    Mono&lt;ServerResponse&gt; blogHandler(ServerRequest request) {<br>        return request.bodyToMono(BlogRequest.class)<br>                .flatMap(this.reqValidator::validateRequest)<br>                .flatMap(reqObject -&gt; {<br>                    return ServerResponse.ok().bodyValue(reqObject);<br>                });<br>    }<br><br>    Mono&lt;ServerResponse&gt; handleException(Throwable error, ServerRequest request) {<br>        return ServerResponse.badRequest().bodyValue(error.getMessage());<br>    }<br>}</pre><p>Artık error handling mekanizmamız herbir endpoint handlerının içerisinde değil. RouterFunctions seviyesinde kontrol ediliyor.</p><p>Bundan sonra ne yapılabilir?</p><ol><li><strong>handleException</strong> metodu bir üst sınıfa taşınabilir. Böylelikle yarın bir gün BlogRoute gibi başka sınıflar da projemize katılırsa, tek bir yerden extend edilerek kullanılabilir.</li><li><strong>GlobalRequestHandler</strong> sınıfında ConstraintViolationException ve IllegalArgumentException hataları fırlatılıyor. Bunların yerine kendimiz <strong>RequestValidationException</strong> isimli bir sınıf oluşturup onu fırlatabiliriz. Bu şekilde tek tip error yakalamış oluruz.</li><li>Gereksiz kafanızı karıştırmamak için yazmadım ama fırlayan exceptionlar anlamlı bir response objesiyle beraber dönebilir.</li></ol><p>Hatta yukarıda dediklerimin yapılmış halini bu yazının <a href="https://github.com/serhatyucell/webFluxFEValidationAndHandling">github reposunda</a> bulabilirsiniz.</p><p><strong>ExceptionHandling için daha global bir çözüm var mı?</strong></p><p>Yukarıdaki çözüm ile beraber, endpointlerimizin abstract bir objeden türemesi gerekiyor ve <strong>Router() </strong>chaininde <strong>.onError()</strong> callbacki ile hata tipine göre handle edilmesi gerekiyor.</p><p>Şimdi bu işi biraz daha geliştirelim endpoint’te herhangi bir .OnError callback metodu kullanmadan ve abstract sınıftan türetmeden, <strong>GlobalExceptionHandler</strong> sınıfı yazarak tüm hataları endpointten bağımsız tek bir noktada handle edelim.</p><pre>@Component<br>@Order(-2)<br>public class GlobalExceptionHandler implements WebExceptionHandler {<br><br>    private final static ObjectMapper objectMapper = new ObjectMapper();<br><br>    //Mono.error(ex) her call edildiğinde handle metodu otomatik olarak çağırılacaktır.<br>    @Override<br>    public Mono&lt;Void&gt; handle(ServerWebExchange exchange, Throwable ex) {<br><br>        //Mono.error(ex) içerisinde BadRequestException taşıyorsa, bunun için bir kırılım olsun.<br>        if (ex instanceof BadRequestException) {<br>            BadRequestException badReqEx = (BadRequestException) ex;<br>            //exchange içerisindeki response body&#39;yi override etmek için DataBuffer gerekiyor<br>            //Ayrı bir metod içerisinde halledelim.<br>            return writeResponseBody(exchange, new BadRequestResponse(badReqEx.getErrorList()));<br>        }<br><br>        //Diğer tüm exception hataları için HTTP statusu 500 olarak setleyip response dönebiliriz.<br>        exchange.getResponse().setStatusCode(HttpStatus.INTERNAL_SERVER_ERROR);<br>        return exchange.getResponse().setComplete();<br><br>    }<br><br>    private Mono&lt;Void&gt; writeResponseBody(ServerWebExchange exchange, Object requestObject) {<br>        try {<br>            DataBuffer dataBuffer = exchange.getResponse().bufferFactory().wrap(objectMapper.writeValueAsBytes(requestObject));<br>            exchange.getResponse().setStatusCode(HttpStatus.BAD_REQUEST);<br>            exchange.getResponse().getHeaders().setContentType(MediaType.APPLICATION_JSON);<br>            return exchange.getResponse().writeWith(Mono.just(dataBuffer));<br>        } catch (Exception e) {<br>            exchange.getResponse().setStatusCode(HttpStatus.INTERNAL_SERVER_ERROR);<br>        }<br><br>        return exchange.getResponse().setComplete();<br>    }<br><br>}</pre><p>Şimdi “<strong>BlogNewRouter</strong>” isimli <em>AbstractRouter</em> sınıfından <strong>türemeyen</strong> ikinci bir functional endpoint oluşturalım hiçbir onError callbacki çağırmadan, <strong>GlobalExceptionHandler</strong>’ın işini yapıp yapmayacağını test edelim.</p><pre>@Configuration<br>public class BlogNewRouter {<br>    @Autowired<br>    GlobalRequestValidationHandler reqValidator;<br>    <br>    @Bean<br>    public RouterFunction&lt;ServerResponse&gt; BlogNewRouter() {<br>        return RouterFunctions.route()<br>                .POST(&quot;blogNew&quot;, this::blogNewHandler)<br>                .build();<br>    }<br>    <br>    Mono&lt;ServerResponse&gt; blogNewHandler(ServerRequest request) {<br>        return request.bodyToMono(BlogRequest.class)<br>                .flatMap(this.reqValidator::validateRequest)<br>                .flatMap(reqObject -&gt; {<br>                    return ServerResponse.ok().bodyValue(reqObject);<br>                });<br>    }<br>}</pre><p>Şimdi test edelim</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*okVDcs9_yEfGjCv8DbKngQ.png" /><figcaption>POST /blogNew</figcaption></figure><p><strong>Neler yaptık?</strong><br>1. <strong>BlogRouter</strong> functional endpointini, router bazlı errorhandling ile kısmen kontrol altına aldık.<br>2.<strong>BlogNewRouter</strong> functional endpointi için genel bir error handler mekanizması kurduk ve <strong>GlobalExceptionHandler</strong> yazarak oluşabilecek tüm hataları tek bir handle üzerinden (bir nevi middleware gibi düşünebilirsiniz) geçirdik ve yönettik.</p><p>Reactive programlamanın ileride çok daha yaygın kullanılacağını düşünüyorum, aklınıza birden fazla çözüm yolu gelebilir, bunları yorum olarak paylaşabilirseniz çok mutlu olurum ufak bir beyin fırtınası yapmış oluruz.</p><p>Okuduğunuz için teşekkür ederim</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=49a1b3071ed2" width="1" height="1" alt=""><hr><p><a href="https://medium.com/ibtech/spring-webflux-functional-endpoint-validasyon-ve-error-handling-49a1b3071ed2">Spring WebFlux Functional Endpoint için Validasyon ve Error Handling</a> was originally published in <a href="https://medium.com/ibtech">IBTech</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>