Hithomelabs/CFTunnels#150: Add Spring Boot Actuator health check endpoints for portainer-automation

- Add spring-boot-starter-actuator dependency to portainer-automation/build.gradle
- Configure management.server.port=8082 with health,info exposure in application.properties
- Map 5005:8082 in portainer-automation/docker-compose.yaml
- Add MGMT_PORT=5005 to portainer-automation/.env.example
- EXPOSE 8081 8082 in portainer-automation Dockerfile
- No ActuatorSecurityConfig needed: service has no Spring Security/OIDC
- Management port stays LAN-only, NOT added to any tunnel ingress

cftunnels-service/src/main/java/com/hithomelabs/cftunnels/Config/Security/ActuatorSecurityConfig.java

@@ -2,9 +2,11 @@ package com.hithomelabs.cftunnels.Config.Security;
 
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
+import org.springframework.core.Ordered;
 import org.springframework.core.annotation.Order;
 import org.springframework.security.config.annotation.web.builders.HttpSecurity;
 import org.springframework.security.web.SecurityFilterChain;
+import org.springframework.boot.actuate.autoconfigure.security.servlet.EndpointRequest;
 
 /**
  * Security configuration for Spring Boot Actuator endpoints.
@@ -12,15 +14,20 @@ import org.springframework.security.web.SecurityFilterChain;
  * This configuration permits unauthenticated access to /actuator/health and /actuator/info
  * endpoints, enabling health monitoring by Uptime Kuma without requiring OIDC authentication.
  * All other actuator endpoints remain protected and require authentication.
+ *
+ * Uses @Order(Ordered.HIGHEST_PRECEDENCE) to ensure this filter chain is evaluated BEFORE
+ * any auto-configured management security filter chains (e.g., ManagementWebSecurityAutoConfiguration).
+ * Without this, the catch-all SecurityFilterChain in SecuirtyConfig can intercept actuator
+ * requests on the separate management port (management.server.port=8081) and redirect to OIDC login.
  */
 @Configuration
+@Order(Ordered.HIGHEST_PRECEDENCE)
 public class ActuatorSecurityConfig {
 
     @Bean
-    @Order(1)
     public SecurityFilterChain actuatorSecurityChain(HttpSecurity http) throws Exception {
         http
-                .securityMatcher("/actuator/**")
+                .securityMatcher(EndpointRequest.toAnyEndpoint())
                 .authorizeHttpRequests(auth -> auth
                         .requestMatchers("/actuator/health", "/actuator/info").permitAll()
                         .anyRequest().authenticated()

cftunnels-service/src/main/java/com/hithomelabs/cftunnels/Config/Security/SecuirtyConfig.java

@@ -29,6 +29,7 @@ public class SecuirtyConfig {
         http
                 .authorizeHttpRequests(auth -> auth
                         //.requestMatchers( "/v3/api-docs/**", "/swagger-ui/**", "/swagger-ui.html" ).permitAll()
+                        .requestMatchers("/actuator/health", "/actuator/info").permitAll()
                         .anyRequest().authenticated()
                 ).csrf(csrf -> csrf.disable())
                 .with(new OAuth2LoginConfigurer<>(),

portainer-automation/.env.example

@@ -36,3 +36,6 @@ ENV=dev
 
 # Host port to map to container port 8081
 HOST_PORT=8081
+
+# Host port to map to actuator management port 8082 (health checks, LAN only)
+MGMT_PORT=5005

portainer-automation/Dockerfile

@@ -9,4 +9,5 @@ RUN ./gradlew :portainer-automation:bootJar
 
 FROM openjdk:17-jdk-slim
 COPY --from=build /app/portainer-automation/build/libs/*.jar app.jar
+EXPOSE 8081 8082
 ENTRYPOINT ["java", "-jar", "/app.jar"]

portainer-automation/build.gradle

@@ -5,6 +5,7 @@ dependencies {
 
     implementation 'org.springframework.boot:spring-boot-starter-web'
     implementation 'org.springframework.boot:spring-boot-starter-validation'
+    implementation 'org.springframework.boot:spring-boot-starter-actuator'
     implementation 'org.apache.httpcomponents.client5:httpclient5'
 
     compileOnly 'org.projectlombok:lombok'

portainer-automation/docker-compose.yaml

@@ -3,7 +3,8 @@ services:
     image: gitea.hithomelabs.com/hithomelabs/portainer-automation:${ENV:-test}
     container_name: portainer-automation_${ENV:-test}
     ports:
-      - "${HOST_PORT:-8081}:8081"
+      - "${HOST_PORT:-8081}:8081"   # Application port (internal service)
+      - "${MGMT_PORT:-5005}:8082"   # Health management port (LAN only)
     environment:
       - SPRING_PROFILES_ACTIVE=${SPRING_PROFILES_ACTIVE:-local}
       - PORTAINER_API_KEY=${PORTAINER_API_KEY}

portainer-automation/src/main/resources/application.properties

@@ -3,3 +3,9 @@ portainer.base-url=https://192.168.0.100:9442
 portainer.api-key=${PORTAINER_API_KEY:}
 portainer.endpoint-id=1
 portainer.service.api-key=${PORTAINER_SERVICE_API_KEY:change-me}
+
+# Actuator configuration - management port and exposed endpoints
+# App runs on server.port=8081, so management port must differ (8082)
+management.server.port=8082
+management.endpoints.web.exposure.include=health,info
+management.endpoint.health.show-details=when-authorized