[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AKRSSVVEAXHZY6YVTFAEKR":3,"skill-same:01M7AKRSSVVEAXHZY6YVTFAEKR":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7AKRSSVVEAXHZY6YVTFAEKR","quarkus-security",null,"Quarkus Security best practices for authentication, authorization, JWT\u002FOIDC, RBAC, input validation, CSRF, secrets management, and dependency security.","Cyrilthetecchieee\u002Fcyril-code-","Cyrilthetecchieee","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F219787998?v=4","01M7AF0MMMKRAA0H61XMJPV92H","Julian Cyril D ","01M7AF0MQ10AVG6QJQ1C2BC0F5",2,"MIT","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Ftr\u002Fskills\u002Fquarkus-security\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: quarkus-security\ndescription: Quarkus Security best practices for authentication, authorization, JWT\u002FOIDC, RBAC, input validation, CSRF, secrets management, and dependency security.\norigin: ECC\n---\n\n# Quarkus Güvenlik İncelemesi\n\nKimlik doğrulama, yetkilendirme ve girdi doğrulama ile Quarkus uygulamalarını güvenli hale getirmek için en iyi uygulamalar.\n\n## When to Use\n\n- Kimlik doğrulama ekleme (JWT, OIDC, Basic Auth)\n- `@RolesAllowed` veya SecurityIdentity ile yetkilendirme uygulama\n- Kullanıcı girişini doğrulama (Bean Validation, özel doğrulayıcılar)\n- CORS veya güvenlik başlıklarını yapılandırma\n- Gizli bilgileri yönetme (Vault, ortam değişkenleri, config kaynakları)\n- Rate limiting veya brute-force koruması ekleme\n- Bağımlılıkları CVE için tarama\n- MicroProfile JWT veya SmallRye JWT ile çalışma\n\n## How It Works\n\nQuarkus güvenliğini katmanlı uygulayın: JWT\u002FOIDC veya Basic Auth ile kimliği\ndoğrulayın, `SecurityIdentity` ve `@RolesAllowed` ile yetki kararlarını\nmerkezileştirin, Bean Validation ile girdileri sınırlandırın, CORS ve güvenlik\nbaşlıklarını açıkça yapılandırın, gizli bilgileri Vault veya ortam değişkenleri\nüzerinden yönetin.\n\n## Examples\n\n### Kimlik Doğrulama\n\n### JWT Kimlik Doğrulama\n\n```java\n\u002F\u002F JWT ile korunan resource\n@Path(\"\u002Fapi\u002Fprotected\")\n@Authenticated\npublic class ProtectedResource {\n\n  @Inject\n  JsonWebToken jwt;\n\n  @Inject\n  SecurityIdentity securityIdentity;\n\n  @GET\n  public Response getData() {\n    String username = jwt.getName();\n    Set\u003CString> roles = jwt.getGroups();\n    return Response.ok(Map.of(\n        \"username\", username,\n        \"roles\", roles,\n        \"principal\", securityIdentity.getPrincipal().getName()\n    )).build();\n  }\n}\n```\n\nYapılandırma (application.properties):\n```properties\nmp.jwt.verify.publickey.location=publicKey.pem\nmp.jwt.verify.issuer=https:\u002F\u002Fauth.example.com\n\n# OIDC\nquarkus.oidc.auth-server-url=https:\u002F\u002Fauth.example.com\u002Frealms\u002Fmyrealm\nquarkus.oidc.client-id=backend-service\nquarkus.oidc.credentials.secret=${OIDC_SECRET}\n```\n\n### Özel Kimlik Doğrulama Filtresi\n\n```java\n@Provider\n@Priority(Priorities.AUTHENTICATION)\npublic class CustomAuthFilter implements ContainerRequestFilter {\n\n  @Inject\n  SecurityIdentity identity;\n\n  @Override\n  public void filter(ContainerRequestContext requestContext) {\n    String authHeader = requestContext.getHeaderString(HttpHeaders.AUTHORIZATION);\n\n    \u002F\u002F Başlık yoksa veya hatalıysa hemen reddet\n    if (authHeader == null || !authHeader.startsWith(\"Bearer \")) {\n      requestContext.abortWith(Response.status(Response.Status.UNAUTHORIZED).build());\n      return;\n    }\n\n    String token = authHeader.substring(7);\n    if (!validateToken(token)) {\n      requestContext.abortWith(Response.status(Response.Status.UNAUTHORIZED).build());\n    }\n  }\n\n  private boolean validateToken(String token) {\n    \u002F\u002F Token doğrulama mantığı\n    return true;\n  }\n}\n```\n\n## Yetkilendirme\n\n### Rol Tabanlı Erişim Kontrolü\n\n```java\n@Path(\"\u002Fapi\u002Fadmin\")\n@RolesAllowed(\"ADMIN\")\npublic class AdminResource {\n\n  @GET\n  @Path(\"\u002Fusers\")\n  public List\u003CUserDto> listUsers() {\n    return userService.findAll();\n  }\n\n  @DELETE\n  @Path(\"\u002Fusers\u002F{id}\")\n  @RolesAllowed({\"ADMIN\", \"SUPER_ADMIN\"})\n  public Response deleteUser(@PathParam(\"id\") Long id) {\n    userService.delete(id);\n    return Response.noContent().build();\n  }\n}\n\n@Path(\"\u002Fapi\u002Fusers\")\npublic class UserResource {\n\n  @Inject\n  SecurityIdentity securityIdentity;\n\n  @GET\n  @Path(\"\u002F{id}\")\n  @RolesAllowed(\"USER\")\n  public Response getUser(@PathParam(\"id\") Long id) {\n    \u002F\u002F Sahipliği kontrol et\n    if (!securityIdentity.hasRole(\"ADMIN\") &&\n        !isOwner(id, securityIdentity.getPrincipal().getName())) {\n      return Response.status(Response.Status.FORBIDDEN).build();\n    }\n    return Response.ok(userService.findById(id)).build();\n  }\n\n  private boolean isOwner(Long userId, String username) {\n    return userService.isOwner(userId, username);\n  }\n}\n```\n\n### Programatik Güvenlik\n\n```java\n@ApplicationScoped\npublic class SecurityService {\n\n  @Inject\n  SecurityIdentity securityIdentity;\n\n  public boolean canAccessResource(Long resourceId) {\n    if (securityIdentity.isAnonymous()) {\n      return false;\n    }\n\n    if (securityIdentity.hasRole(\"ADMIN\")) {\n      return true;\n    }\n\n    String userId = securityIdentity.getPrincipal().getName();\n    return resourceRepository.isOwner(resourceId, userId);\n  }\n}\n```\n\n## Girdi Doğrulama\n\n### Bean Validation\n\n```java\n\u002F\u002F KÖTÜ: Validation yok\n@POST\npublic Response createUser(UserDto dto) {\n  return Response.ok(userService.create(dto)).build();\n}\n\n\u002F\u002F İYİ: Doğrulanmış DTO\npublic record CreateUserDto(\n    @NotBlank @Size(max = 100) String name,\n    @NotBlank @Email String email,\n    @NotNull @Min(18) @Max(150) Integer age,\n    @Pattern(regexp = \"^\\\\+?[1-9]\\\\d{1,14}$\") String phone\n) {}\n\n@POST\n@Path(\"\u002Fusers\")\npublic Response createUser(@Valid CreateUserDto dto) {\n  User user = userService.create(dto);\n  return Response.status(Response.Status.CREATED).entity(user).build();\n}\n```\n\n### Özel Doğrulayıcılar\n\n```java\n@Target({ElementType.FIELD, ElementType.PARAMETER})\n@Retention(RetentionPolicy.RUNTIME)\n@Constraint(validatedBy = UsernameValidator.class)\npublic @interface ValidUsername {\n  String message() default \"Invalid username format\";\n  Class\u003C?>[] groups() default {};\n  Class\u003C? extends Payload>[] payload() default {};\n}\n\npublic class UsernameValidator implements ConstraintValidator\u003CValidUsername, String> {\n  @Override\n  public boolean isValid(String value, ConstraintValidatorContext context) {\n    if (value == null) return false;\n    return value.matches(\"^[a-zA-Z0-9_-]{3,20}$\");\n  }\n}\n\n\u002F\u002F Kullanım\npublic record CreateUserDto(\n    @ValidUsername String username,\n    @NotBlank @Email String email\n) {}\n```\n\n## SQL Injection Önleme\n\n### Panache Active Record (Varsayılan Olarak Güvenli)\n\n```java\n\u002F\u002F İYİ: Panache ile parametreli sorgular\nList\u003CUser> users = User.list(\"email = ?1 and active = ?2\", email, true);\n\nOptional\u003CUser> user = User.find(\"username\", username).firstResultOptional();\n\n\u002F\u002F İYİ: İsimlendirilmiş parametreler\nList\u003CUser> users = User.list(\"email = :email and age > :minAge\",\n    Parameters.with(\"email\", email).and(\"minAge\", 18));\n```\n\n### Native Sorgular (Parametre Kullanın)\n\n```java\n\u002F\u002F KÖTÜ: String birleştirme\n@Query(value = \"SELECT * FROM users WHERE name = '\" + name + \"'\", nativeQuery = true)\n\n\u002F\u002F İYİ: Parametreli native sorgu\n@Entity\npublic class User extends PanacheEntity {\n  public static List\u003CUser> findByEmailNative(String email) {\n    return getEntityManager()\n        .createNativeQuery(\"SELECT * FROM users WHERE email = :email\", User.class)\n        .setParameter(\"email\", email)\n        .getResultList();\n  }\n}\n```\n\n## Parola Hash'leme\n\n```java\n@ApplicationScoped\npublic class PasswordService {\n\n  public String hash(String plainPassword) {\n    return BcryptUtil.bcryptHash(plainPassword);\n  }\n\n  public boolean verify(String plainPassword, String hashedPassword) {\n    return BcryptUtil.matches(plainPassword, hashedPassword);\n  }\n}\n\n\u002F\u002F Servis içinde\n@ApplicationScoped\npublic class UserService {\n  @Inject\n  PasswordService passwordService;\n\n  @Transactional\n  public User register(CreateUserDto dto) {\n    String hashedPassword = passwordService.hash(dto.password());\n    User user = new User();\n    user.email = dto.email();\n    user.password = hashedPassword;\n    user.persist();\n    return user;\n  }\n\n  public boolean authenticate(String email, String password) {\n    return User.find(\"email\", email)\n        .firstResultOptional()\n        .map(u -> passwordService.verify(password, u.password))\n        .orElse(false);\n  }\n}\n```\n\n## CORS Yapılandırması\n\n```properties\n# application.properties\nquarkus.http.cors=true\nquarkus.http.cors.origins=https:\u002F\u002Fapp.example.com,https:\u002F\u002Fadmin.example.com\nquarkus.http.cors.methods=GET,POST,PUT,DELETE\nquarkus.http.cors.headers=accept,authorization,content-type,x-requested-with\nquarkus.http.cors.exposed-headers=Content-Disposition\nquarkus.http.cors.access-control-max-age=24H\nquarkus.http.cors.access-control-allow-credentials=true\n```\n\n## Gizli Bilgi Yönetimi\n\n```properties\n# application.properties - BURADA GİZLİ BİLGİ YOK\n\n# Ortam değişkenlerini kullanın\nquarkus.datasource.username=${DB_USER}\nquarkus.datasource.password=${DB_PASSWORD}\nquarkus.oidc.credentials.secret=${OIDC_CLIENT_SECRET}\n\n# Or use Vault\nquarkus.vault.url=https:\u002F\u002Fvault.example.com\nquarkus.vault.authentication.kubernetes.role=my-role\n```\n\n### HashiCorp Vault Entegrasyonu\n\n```java\n@ApplicationScoped\npublic class SecretService {\n\n  @ConfigProperty(name = \"api-key\")\n  String apiKey; \u002F\u002F Vault'tan alınır\n\n  public String getSecret(String key) {\n    return ConfigProvider.getConfig().getValue(key, String.class);\n  }\n}\n```\n\n## Rate Limiting (Hız Sınırlama)\n\n**Güvenlik Notu**: `X-Forwarded-For` doğrudan kullanmayın — istemciler bunu taklit edebilir.\nServlet request'ten gerçek uzak adresi veya kimliği doğrulanmış bir kimlik (API anahtarı, JWT subject) kullanın.\n\n```java\n@ApplicationScoped\npublic class RateLimitFilter implements ContainerRequestFilter {\n  private final Map\u003CString, RateLimiter> limiters = new ConcurrentHashMap\u003C>();\n\n  @Inject\n  HttpServletRequest servletRequest;\n\n  @Override\n  public void filter(ContainerRequestContext requestContext) {\n    String clientId = getClientIdentifier();\n    RateLimiter limiter = limiters.computeIfAbsent(clientId,\n        k -> RateLimiter.create(100.0)); \u002F\u002F Saniyede 100 istek\n\n    if (!limiter.tryAcquire()) {\n      requestContext.abortWith(\n          Response.status(429)\n              .entity(Map.of(\"error\", \"Too many requests\"))\n              .build()\n      );\n    }\n  }\n\n  private String getClientIdentifier() {\n    \u002F\u002F Konteyner tarafından sağlanan uzak adresi kullanın (X-Forwarded-For değil).\n    \u002F\u002F Güvenilir proxy arkasındaysanız quarkus.http.proxy.proxy-address-forwarding=true ayarlayın.\n    return servletRequest.getRemoteAddr();\n  }\n}\n```\n\n## Güvenlik Başlıkları\n\n```java\n@Provider\npublic class SecurityHeadersFilter implements ContainerResponseFilter {\n\n  @Override\n  public void filter(ContainerRequestContext request, ContainerResponseContext response) {\n    MultivaluedMap\u003CString, Object> headers = response.getHeaders();\n\n    \u002F\u002F Clickjacking'i önle\n    headers.putSingle(\"X-Frame-Options\", \"DENY\");\n\n    \u002F\u002F XSS koruması\n    headers.putSingle(\"X-Content-Type-Options\", \"nosniff\");\n    headers.putSingle(\"X-XSS-Protection\", \"1; mode=block\");\n\n    \u002F\u002F HSTS\n    headers.putSingle(\"Strict-Transport-Security\", \"max-age=31536000; includeSubDomains\");\n\n    \u002F\u002F CSP — script-src için 'unsafe-inline' kullanmayın, XSS korumasını etkisiz kılar;\n    \u002F\u002F bunun yerine nonce veya hash kullanın\n    headers.putSingle(\"Content-Security-Policy\",\n        \"default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'\");\n  }\n}\n```\n\n## Denetim Loglama\n\n```java\n@ApplicationScoped\npublic class AuditService {\n  private static final Logger LOG = Logger.getLogger(AuditService.class);\n\n  @Inject\n  SecurityIdentity securityIdentity;\n\n  public void logAccess(String resource, String action) {\n    String user = securityIdentity.isAnonymous()\n        ? \"anonymous\"\n        : securityIdentity.getPrincipal().getName();\n\n    LOG.infof(\"AUDIT: user=%s action=%s resource=%s timestamp=%s\",\n        user, action, resource, Instant.now());\n  }\n}\n\n\u002F\u002F Resource içinde kullanım\n@Path(\"\u002Fapi\u002Fsensitive\")\npublic class SensitiveResource {\n  @Inject\n  AuditService auditService;\n\n  @GET\n  @RolesAllowed(\"ADMIN\")\n  public Response getData() {\n    auditService.logAccess(\"sensitive-data\", \"READ\");\n    return Response.ok(data).build();\n  }\n}\n```\n\n## Bağımlılık Güvenliği Taraması\n\n```bash\n# Maven\nmvn org.owasp:dependency-check-maven:check\n\n# Gradle\n.\u002Fgradlew dependencyCheckAnalyze\n\n# Check Quarkus extensions\nquarkus extension list --installable\n```\n\n## En İyi Uygulamalar\n\n- Production'da her zaman HTTPS kullanın\n- Stateless kimlik doğrulama için JWT veya OIDC etkinleştirin\n- Bildirimsel yetkilendirme için `@RolesAllowed` kullanın\n- Bean Validation ile tüm girişleri doğrulayın\n- Parolaları BCrypt ile hash'leyin (asla düz metin saklamayın)\n- Gizli bilgileri Vault veya ortam değişkenlerinde saklayın\n- SQL injection'ı önlemek için parametreli sorgular kullanın\n- Tüm yanıtlara güvenlik başlıkları ekleyin\n- Genel endpoint'lerde rate limiting uygulayın\n- Hassas işlemleri denetleyin\n- Bağımlılıkları güncel tutun ve CVE için tarayın\n- Programatik kontroller için SecurityIdentity kullanın\n- Uygun CORS politikaları belirleyin\n- Kimlik doğrulama ve yetkilendirme yollarını test edin\n","# Quarkus Güvenlik İncelemesi\n\nKimlik doğrulama, yetkilendirme ve girdi doğrulama ile Quarkus uygulamalarını güvenli hale getirmek için en iyi uygulamalar.\n\n## When to Use\n\n- Kimlik doğrulama ekleme (JWT, OIDC, Basic Auth)\n- `@RolesAllowed` veya SecurityIdentity ile yetkilendirme uygulama\n- Kullanıcı girişini doğrulama (Bean Validation, özel doğrulayıcılar)\n- CORS veya güvenlik başlıklarını yapılandırma\n- Gizli bilgileri yönetme (Vault, ortam değişkenleri, config kaynakları)\n- Rate limiting veya brute-force koruması ekleme\n- Bağımlılıkları CVE için tarama\n- MicroProfile JWT veya SmallRye JWT ile çalışma\n\n## How It Works\n\nQuarkus güvenliğini katmanlı uygulayın: JWT\u002FOIDC veya Basic Auth ile kimliği\ndoğrulayın, `SecurityIdentity` ve `@RolesAllowed` ile yetki kararlarını\nmerkezileştirin, Bean Validation ile girdileri sınırlandırın, CORS ve güvenlik\nbaşlıklarını açıkça yapılandırın, gizli bilgileri Vault veya ortam değişkenleri\nüzerinden yönetin.\n\n## Examples\n\n### Kimlik Doğrulama\n\n### JWT Kimlik Doğrulama\n\n```java\n\u002F\u002F JWT ile korunan resource\n@Path(\"\u002Fapi\u002Fprotected\")\n@Authenticated\npublic class ProtectedResource {\n\n  @Inject\n  JsonWebToken jwt;\n\n  @Inject\n  SecurityIdentity securityIdentity;\n\n  @GET\n  public Response getData() {\n    String username = jwt.getName();\n    Set\u003CString> roles = jwt.getGroups();\n    return Response.ok(Map.of(\n        \"username\", username,\n        \"roles\", roles,\n        \"principal\", securityIdentity.getPrincipal().getName()\n    )).build();\n  }\n}\n```\n\nYapılandırma (application.properties):\n```properties\nmp.jwt.verify.publickey.location=publicKey.pem\nmp.jwt.verify.issuer=https:\u002F\u002Fauth.example.com\n\n# OIDC\nquarkus.oidc.auth-server-url=https:\u002F\u002Fauth.example.com\u002Frealms\u002Fmyrealm\nquarkus.oidc.client-id=backend-service\nquarkus.oidc.credentials.secret=${OIDC_SECRET}\n```\n\n### Özel Kimlik Doğrulama Filtresi\n\n```java\n@Provider\n@Priority(Priorities.AUTHENTICATION)\npublic class CustomAuthFilter implements ContainerRequestFilter {\n\n  @Inject\n  SecurityIdentity identity;\n\n  @Override\n  public void filter(ContainerRequestContext requestContext) {\n    String authHeader = requestContext.getHeaderString(HttpHeaders.AUTHORIZATION);\n\n    \u002F\u002F Başlık yoksa veya hatalıysa hemen reddet\n    if (authHeader == null || !authHeader.startsWith(\"Bearer \")) {\n      requestContext.abortWith(Response.status(Response.Status.UNAUTHORIZED).build());\n      return;\n    }\n\n    String token = authHeader.substring(7);\n    if (!validateToken(token)) {\n      requestContext.abortWith(Response.status(Response.Status.UNAUTHORIZED).build());\n    }\n  }\n\n  private boolean validateToken(String token) {\n    \u002F\u002F Token doğrulama mantığı\n    return true;\n  }\n}\n```\n\n## Yetkilendirme\n\n### Rol Tabanlı Erişim Kontrolü\n\n```java\n@Path(\"\u002Fapi\u002Fadmin\")\n@RolesAllowed(\"ADMIN\")\npublic class AdminResource {\n\n  @GET\n  @Path(\"\u002Fusers\")\n  public List\u003CUserDto> listUsers() {\n    return userService.findAll();\n  }\n\n  @DELETE\n  @Path(\"\u002Fusers\u002F{id}\")\n  @RolesAllowed({\"ADMIN\", \"SUPER_ADMIN\"})\n  public Response deleteUser(@PathParam(\"id\") Long id) {\n    userService.delete(id);\n    return Response.noContent().build();\n  }\n}\n\n@Path(\"\u002Fapi\u002Fusers\")\npublic class UserResource {\n\n  @Inject\n  SecurityIdentity securityIdentity;\n\n  @GET\n  @Path(\"\u002F{id}\")\n  @RolesAllowed(\"USER\")\n  public Response getUser(@PathParam(\"id\") Long id) {\n    \u002F\u002F Sahipliği kontrol et\n    if (!securityIdentity.hasRole(\"ADMIN\") &&\n        !isOwner(id, securityIdentity.getPrincipal().getName())) {\n      return Response.status(Response.Status.FORBIDDEN).build();\n    }\n    return Response.ok(userService.findById(id)).build();\n  }\n\n  private boolean isOwner(Long userId, String username) {\n    return userService.isOwner(userId, username);\n  }\n}\n```\n\n### Programatik Güvenlik\n\n```java\n@ApplicationScoped\npublic class SecurityService {\n\n  @Inject\n  SecurityIdentity securityIdentity;\n\n  public boolean canAccessResource(Long resourceId) {\n    if (securityIdentity.isAnonymous()) {\n      return false;\n    }\n\n    if (securityIdentity.hasRole(\"ADMIN\")) {\n      return true;\n    }\n\n    String userId = securityIdentity.getPrincipal().getName();\n    return resourceRepository.isOwner(resourceId, userId);\n  }\n}\n```\n\n## Girdi Doğrulama\n\n### Bean Validation\n\n```java\n\u002F\u002F KÖTÜ: Validation yok\n@POST\npublic Response createUser(UserDto dto) {\n  return Response.ok(userService.create(dto)).build();\n}\n\n\u002F\u002F İYİ: Doğrulanmış DTO\npublic record CreateUserDto(\n    @NotBlank @Size(max = 100) String name,\n    @NotBlank @Email String email,\n    @NotNull @Min(18) @Max(150) Integer age,\n    @Pattern(regexp = \"^\\\\+?[1-9]\\\\d{1,14}$\") String phone\n) {}\n\n@POST\n@Path(\"\u002Fusers\")\npublic Response createUser(@Valid CreateUserDto dto) {\n  User user = userService.create(dto);\n  return Response.status(Response.Status.CREATED).entity(user).build();\n}\n```\n\n### Özel Doğrulayıcılar\n\n```java\n@Target({ElementType.FIELD, ElementType.PARAMETER})\n@Retention(RetentionPolicy.RUNTIME)\n@Constraint(validatedBy = UsernameValidator.class)\npublic @interface ValidUsername {\n  String message() default \"Invalid username format\";\n  Class\u003C?>[] groups() default {};\n  Class\u003C? extends Payload>[] payload() default {};\n}\n\npublic class UsernameValidator implements ConstraintValidator\u003CValidUsername, String> {\n  @Override\n  public boolean isValid(String value, ConstraintValidatorContext context) {\n    if (value == null) return false;\n    return value.matches(\"^[a-zA-Z0-9_-]{3,20}$\");\n  }\n}\n\n\u002F\u002F Kullanım\npublic record CreateUserDto(\n    @ValidUsername String username,\n    @NotBlank @Email String email\n) {}\n```\n\n## SQL Injection Önleme\n\n### Panache Active Record (Varsayılan Olarak Güvenli)\n\n```java\n\u002F\u002F İYİ: Panache ile parametreli sorgular\nList\u003CUser> users = User.list(\"email = ?1 and active = ?2\", email, true);\n\nOptional\u003CUser> user = User.find(\"username\", username).firstResultOptional();\n\n\u002F\u002F İYİ: İsimlendirilmiş parametreler\nList\u003CUser> users = User.list(\"email = :email and age > :minAge\",\n    Parameters.with(\"email\", email).and(\"minAge\", 18));\n```\n\n### Native Sorgular (Parametre Kullanın)\n\n```java\n\u002F\u002F KÖTÜ: String birleştirme\n@Query(value = \"SELECT * FROM users WHERE name = '\" + name + \"'\", nativeQuery = true)\n\n\u002F\u002F İYİ: Parametreli native sorgu\n@Entity\npublic class User extends PanacheEntity {\n  public static List\u003CUser> findByEmailNative(String email) {\n    return getEntityManager()\n        .createNativeQuery(\"SELECT * FROM users WHERE email = :email\", User.class)\n        .setParameter(\"email\", email)\n        .getResultList();\n  }\n}\n```\n\n## Parola Hash'leme\n\n```java\n@ApplicationScoped\npublic class PasswordService {\n\n  public String hash(String plainPassword) {\n    return BcryptUtil.bcryptHash(plainPassword);\n  }\n\n  public boolean verify(String plainPassword, String hashedPassword) {\n    return BcryptUtil.matches(plainPassword, hashedPassword);\n  }\n}\n\n\u002F\u002F Servis içinde\n@ApplicationScoped\npublic class UserService {\n  @Inject\n  PasswordService passwordService;\n\n  @Transactional\n  public User register(CreateUserDto dto) {\n    String hashedPassword = passwordService.hash(dto.password());\n    User user = new User();\n    user.email = dto.email();\n    user.password = hashedPassword;\n    user.persist();\n    return user;\n  }\n\n  public boolean authenticate(String email, String password) {\n    return User.find(\"email\", email)\n        .firstResultOptional()\n        .map(u -> passwordService.verify(password, u.password))\n        .orElse(false);\n  }\n}\n```\n\n## CORS Yapılandırması\n\n```properties\n# application.properties\nquarkus.http.cors=true\nquarkus.http.cors.origins=https:\u002F\u002Fapp.example.com,https:\u002F\u002Fadmin.example.com\nquarkus.http.cors.methods=GET,POST,PUT,DELETE\nquarkus.http.cors.headers=accept,authorization,content-type,x-requested-with\nquarkus.http.cors.exposed-headers=Content-Disposition\nquarkus.http.cors.access-control-max-age=24H\nquarkus.http.cors.access-control-allow-credentials=true\n```\n\n## Gizli Bilgi Yönetimi\n\n```properties\n# application.properties - BURADA GİZLİ BİLGİ YOK\n\n# Ortam değişkenlerini kullanın\nquarkus.datasource.username=${DB_USER}\nquarkus.datasource.password=${DB_PASSWORD}\nquarkus.oidc.credentials.secret=${OIDC_CLIENT_SECRET}\n\n# Or use Vault\nquarkus.vault.url=https:\u002F\u002Fvault.example.com\nquarkus.vault.authentication.kubernetes.role=my-role\n```\n\n### HashiCorp Vault Entegrasyonu\n\n```java\n@ApplicationScoped\npublic class SecretService {\n\n  @ConfigProperty(name = \"api-key\")\n  String apiKey; \u002F\u002F Vault'tan alınır\n\n  public String getSecret(String key) {\n    return ConfigProvider.getConfig().getValue(key, String.class);\n  }\n}\n```\n\n## Rate Limiting (Hız Sınırlama)\n\n**Güvenlik Notu**: `X-Forwarded-For` doğrudan kullanmayın — istemciler bunu taklit edebilir.\nServlet request'ten gerçek uzak adresi veya kimliği doğrulanmış bir kimlik (API anahtarı, JWT subject) kullanın.\n\n```java\n@ApplicationScoped\npublic class RateLimitFilter implements ContainerRequestFilter {\n  private final Map\u003CString, RateLimiter> limiters = new ConcurrentHashMap\u003C>();\n\n  @Inject\n  HttpServletRequest servletRequest;\n\n  @Override\n  public void filter(ContainerRequestContext requestContext) {\n    String clientId = getClientIdentifier();\n    RateLimiter limiter = limiters.computeIfAbsent(clientId,\n        k -> RateLimiter.create(100.0)); \u002F\u002F Saniyede 100 istek\n\n    if (!limiter.tryAcquire()) {\n      requestContext.abortWith(\n          Response.status(429)\n              .entity(Map.of(\"error\", \"Too many requests\"))\n              .build()\n      );\n    }\n  }\n\n  private String getClientIdentifier() {\n    \u002F\u002F Konteyner tarafından sağlanan uzak adresi kullanın (X-Forwarded-For değil).\n    \u002F\u002F Güvenilir proxy arkasındaysanız quarkus.http.proxy.proxy-address-forwarding=true ayarlayın.\n    return servletRequest.getRemoteAddr();\n  }\n}\n```\n\n## Güvenlik Başlıkları\n\n```java\n@Provider\npublic class SecurityHeadersFilter implements ContainerResponseFilter {\n\n  @Override\n  public void filter(ContainerRequestContext request, ContainerResponseContext response) {\n    MultivaluedMap\u003CString, Object> headers = response.getHeaders();\n\n    \u002F\u002F Clickjacking'i önle\n    headers.putSingle(\"X-Frame-Options\", \"DENY\");\n\n    \u002F\u002F XSS koruması\n    headers.putSingle(\"X-Content-Type-Options\", \"nosniff\");\n    headers.putSingle(\"X-XSS-Protection\", \"1; mode=block\");\n\n    \u002F\u002F HSTS\n    headers.putSingle(\"Strict-Transport-Security\", \"max-age=31536000; includeSubDomains\");\n\n    \u002F\u002F CSP — script-src için 'unsafe-inline' kullanmayın, XSS korumasını etkisiz kılar;\n    \u002F\u002F bunun yerine nonce veya hash kullanın\n    headers.putSingle(\"Content-Security-Policy\",\n        \"default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'\");\n  }\n}\n```\n\n## Denetim Loglama\n\n```java\n@ApplicationScoped\npublic class AuditService {\n  private static final Logger LOG = Logger.getLogger(AuditService.class);\n\n  @Inject\n  SecurityIdentity securityIdentity;\n\n  public void logAccess(String resource, String action) {\n    String user = securityIdentity.isAnonymous()\n        ? \"anonymous\"\n        : securityIdentity.getPrincipal().getName();\n\n    LOG.infof(\"AUDIT: user=%s action=%s resource=%s timestamp=%s\",\n        user, action, resource, Instant.now());\n  }\n}\n\n\u002F\u002F Resource içinde kullanım\n@Path(\"\u002Fapi\u002Fsensitive\")\npublic class SensitiveResource {\n  @Inject\n  AuditService auditService;\n\n  @GET\n  @RolesAllowed(\"ADMIN\")\n  public Response getData() {\n    auditService.logAccess(\"sensitive-data\", \"READ\");\n    return Response.ok(data).build();\n  }\n}\n```\n\n## Bağımlılık Güvenliği Taraması\n\n```bash\n# Maven\nmvn org.owasp:dependency-check-maven:check\n\n# Gradle\n.\u002Fgradlew dependencyCheckAnalyze\n\n# Check Quarkus extensions\nquarkus extension list --installable\n```\n\n## En İyi Uygulamalar\n\n- Production'da her zaman HTTPS kullanın\n- Stateless kimlik doğrulama için JWT veya OIDC etkinleştirin\n- Bildirimsel yetkilendirme için `@RolesAllowed` kullanın\n- Bean Validation ile tüm girişleri doğrulayın\n- Parolaları BCrypt ile hash'leyin (asla düz metin saklamayın)\n- Gizli bilgileri Vault veya ortam değişkenlerinde saklayın\n- SQL injection'ı önlemek için parametreli sorgular kullanın\n- Tüm yanıtlara güvenlik başlıkları ekleyin\n- Genel endpoint'lerde rate limiting uygulayın\n- Hassas işlemleri denetleyin\n- Bağımlılıkları güncel tutun ve CVE için tarayın\n- Programatik kontroller için SecurityIdentity kullanın\n- Uygun CORS politikaları belirleyin\n- Kimlik doğrulama ve yetkilendirme yollarını test edin\n",{"name":5,"origin":24,"description":7},"ECC","main","57e7aa6b6e03bce1a7d7862ba9c2ec312f7f19b5","src\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Ftr\u002Fskills\u002Fquarkus-security",0,"https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee","https:\u002F\u002Fwithcyril.me\u002F","Hi, I’m Julian Cyril D, a Computer Science and Business Systems student at PSNACET.\r\nI’m passionate about full-stack development, UI\u002FUX design, and building sma","2026-11-04 23:28:50",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add Cyrilthetecchieee\u002Fcyril-code- --skill quarkus-security",{"tool":40,"command":41},"bunx","bunx skills add Cyrilthetecchieee\u002Fcyril-code- --skill quarkus-security",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Cyrilthetecchieee\u002Fcyril-code- --skill quarkus-security","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Ftr\u002Fskills\u002Fquarkus-security\u002FSKILL.md",true,[],[49,58,65,73,80,87],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":54,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M7AQV6CYX8RMC78420V9WZ62","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7AQV2895N3S1MEX6K76G6G2","youtube-downloader","Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fvideo-downloader\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":69,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7AQTRNX62DNKVZ5GXEHRBKB","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7AQTNNVHAAN9H6DA8T6ZVE0","template-skill","Replace with description of the skill and when Claude should use it.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftemplate-skill\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7AQTJ3MQ6AKX152MEX2MYCC","tailored-resume-generator","Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftailored-resume-generator\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":53,"licenseFileUrl":91,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7AQTD7D5MYET2YWG7HG9WM3","slack-gif-creator","Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like \"make me a GIF for Slack of X doing Y\".","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FSKILL.md",[],[]]