[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BF5JBQ8MCAR6BWSV3T1FJ9":3,"skill-same:01M7BF5JBQ8MCAR6BWSV3T1FJ9":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":30,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7BF5JBQ8MCAR6BWSV3T1FJ9","quarkus-security",null,"Quarkus Security best practices for authentication, authorization, JWT\u002FOIDC, RBAC, input validation, CSRF, secrets management, and dependency security.","YYC-Cube\u002FYYC3-Knowledge-Base","YYC-Cube","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F235006543?v=4","01M79J2PH4SWD2X0825X6PN748","yyc3","01M79J2PHVK3F6ZBYT8K2SCZCW",1,"MIT","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-AI-应用工具\u002FYYC3-AI-应用工具-Everything-claude-code\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","87afe6ce96220accf50a345dea46784c8c9f210e","YYC3-AI-应用工具\u002FYYC3-AI-应用工具-Everything-claude-code\u002Fdocs\u002Ftr\u002Fskills\u002Fquarkus-security",0,"https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base","https:\u002F\u002Fkb.yyc3.top\u002F","https:\u002F\u002Fgithub.com\u002FYYC-Cube","万象归元于云枢 | 深栈智启新纪元","2026-11-10 10:37:32",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill quarkus-security",{"tool":40,"command":41},"bunx","bunx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill quarkus-security",{"tool":43,"command":44},"pnpm","pnpm dlx skills add YYC-Cube\u002FYYC3-Knowledge-Base --skill quarkus-security","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-AI-应用工具\u002FYYC3-AI-应用工具-Everything-claude-code\u002Fdocs\u002Ftr\u002Fskills\u002Fquarkus-security\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"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":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7CTDWHERCXPQCP0K03A86AS","vercel-sandbox","Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include \"Vercel Sandbox browser\", \"microVM Chrome\", \"agent-browser in sandbox\", \"browser automation on Vercel\", or any task requiring Chrome in a Vercel Sandbox.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fvercel-sandbox\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7CTD8D2BNJY54S65M47HEJA","slack","Interact with Slack workspaces using browser automation. Use when the user needs to check unread channels, navigate Slack, send messages, extract data, find information, search conversations, or automate any Slack task. Triggers include \"check my Slack\", \"what channels have unreads\", \"send a message to\", \"search Slack for\", \"extract from Slack\", \"find who said\", or any task requiring programmatic Slack interaction.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fslack\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7CTCSSB8ZP3Q58C3YZDZK1W","electron","Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include \"automate Slack app\", \"control VS Code\", \"interact with Discord app\", \"test this Electron app\", \"connect to desktop app\", or any task requiring automation of a native Electron application.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Felectron\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7CTCBJY76688V4DCZGWFHGQ","dogfood","Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to \"dogfood\", \"QA\", \"exploratory test\", \"find issues\", \"bug hunt\", \"test this app\u002Fsite\u002Fplatform\", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step-by-step screenshots, repro videos, and detailed repro steps for every issue -- so findings can be handed directly to the responsible teams.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fdogfood\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7CTC4H0FFGVEAQR9PA4GA1A","agent-browser","Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to \"open a website\", \"fill out a form\", \"click a button\", \"take a screenshot\", \"scrape data from a page\", \"test this web app\", \"login to a site\", \"automate browser actions\", or any task requiring programmatic web interaction.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-WebSpec-Web标准\u002FYYC3-WebSpec-Web标准-standards\u002Fbrowser-agent\u002Fskills\u002Fagent-browser\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7CTBKVFYBG78FDSABSDJTTQ","shadcn","Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI, including chat interfaces. Provides project context, component docs, and usage examples. Applies when working with shadcn\u002Fui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for \"shadcn init\", \"create an app with --preset\", \"switch to --preset\", and for building a design system or applying a DESIGN.md or brand spec to shadcn\u002Fui.","https:\u002F\u002Fgithub.com\u002FYYC-Cube\u002FYYC3-Knowledge-Base\u002Fblob\u002Fmain\u002FYYC3-UI-界面组件\u002FYYC3-UI-界面组件-ui\u002Fskills\u002Fshadcn\u002FSKILL.md",[],[]]