attachment/attachments/kong/plugins/open-appsec-waf-kong-plugin/handler.lua

local module_name = ...
local prefix = module_name:match("^(.-)handler$")
local nano = require(prefix .. "nano_ffi")
local kong = kong

local NanoHandler = {}

NanoHandler.PRIORITY = 3000
NanoHandler.VERSION = "1.0.0"

NanoHandler.sessions = {}
NanoHandler.processed_requests = {}

function NanoHandler.init_worker()
    nano.init_attachment()
end

-- **Handles Request Headers (DecodeHeaders Equivalent)**
function NanoHandler.access(conf)
    local headers = kong.request.get_headers()
    local session_id = nano.generate_session_id()
    kong.service.request.set_header("x-session-id", tostring(session_id))

    if NanoHandler.processed_requests[session_id] then
        kong.ctx.plugin.blocked = true
        return
    end

    local session_data = nano.init_session(session_id)
    if not session_data then
        kong.log.err("Failed to initialize session - failing open")
        return
    end

    kong.ctx.plugin.session_data = session_data
    kong.ctx.plugin.session_id = session_id

    local meta_data = nano.handle_start_transaction()
    if not meta_data then
    kong.log.err("Failed to handle start transaction - failing open")
        return
    end
    
    local req_headers = nano.handleHeaders(headers)

    local has_content_length = tonumber(ngx.var.http_content_length) and tonumber(ngx.var.http_content_length) > 0
    local contains_body = has_content_length and 1 or 0

    local verdict, response = nano.send_data(session_id, session_data, meta_data, req_headers, contains_body, nano.HttpChunkType.HTTP_REQUEST_FILTER)
    if verdict == nano.AttachmentVerdict.DROP then
        nano.fini_session(session_data)
        kong.ctx.plugin.blocked = true
        local result = nano.handle_custom_response(session_data, response)
        nano.cleanup_all()
        return result
    end

    if contains_body == 1 then
        local body = kong.request.get_raw_body()
        if body and #body > 0 then
            verdict, response = nano.send_body(session_id, session_data, body, nano.HttpChunkType.HTTP_REQUEST_BODY)
            if verdict == nano.AttachmentVerdict.DROP then
                nano.fini_session(session_data)
                kong.ctx.plugin.blocked = true
                local result = nano.handle_custom_response(session_data, response)
                nano.cleanup_all()
                return result
            end
        else
            kong.log.debug("Request body not in memory, attempting to read from buffer/file")

            local body_data = ngx.var.request_body
            if body_data and #body_data > 0 then
                kong.log.debug("Found request body in nginx var, size: ", #body_data)
                verdict, response = nano.send_body(session_id, session_data, body_data, nano.HttpChunkType.HTTP_REQUEST_BODY)
                if verdict == nano.AttachmentVerdict.DROP then
                    nano.fini_session(session_data)
                    kong.ctx.plugin.blocked = true
                    return nano.handle_custom_response(session_data, response)
                end
            else
                local body_file = ngx.var.request_body_file
                if body_file then
                    kong.log.debug("Reading request body from file: ", body_file)
                    local file = io.open(body_file, "rb")
                    if file then
                        local entire_body = file:read("*all")
                        file:close()

                        if entire_body and #entire_body > 0 then
                            kong.log.debug("Sending entire body of size ", #entire_body, " bytes to C module")
                            verdict, response = nano.send_body(session_id, session_data, entire_body, nano.HttpChunkType.HTTP_REQUEST_BODY)
                            if verdict == nano.AttachmentVerdict.DROP then
                                nano.fini_session(session_data)
                                kong.ctx.plugin.blocked = true
                                local result = nano.handle_custom_response(session_data, response)
                                nano.cleanup_all()
                                return result
                            end
                        else
                            kong.log.debug("Empty body file")
                        end
                    end
                else
                    kong.log.warn("Request body expected but no body data or file available")
                end
            end
        end

        local ok, verdict, response  = pcall(function()
            return nano.end_inspection(session_id, session_data, nano.HttpChunkType.HTTP_REQUEST_END)
        end)

        if not ok then
            kong.log.err("Error ending request inspection: ", verdict, " - failing open")
            nano.fini_session(session_data)
            nano.cleanup_all()
            return
        end

        if verdict == nano.AttachmentVerdict.DROP then
            nano.fini_session(session_data)
            kong.ctx.plugin.blocked = true
            local result = nano.handle_custom_response(session_data, response)
            nano.cleanup_all()
            return result
        end
    else
        verdict, response = nano.end_inspection(session_id, session_data, nano.HttpChunkType.HTTP_REQUEST_END)
        if verdict == nano.AttachmentVerdict.DROP then
            nano.fini_session(session_data)
            kong.ctx.plugin.blocked = true
            local result = nano.handle_custom_response(session_data, response)
            nano.cleanup_all()
            return result
        end
    end

    NanoHandler.processed_requests[session_id] = true
end

function NanoHandler.header_filter(conf)
    local ctx = kong.ctx.plugin
    if ctx.blocked then
        return
    end

    local session_id = ctx.session_id
    local session_data = ctx.session_data

    if not session_id or not session_data then
        kong.log.err("No session data found in header_filter")
        return
    end

    local headers = kong.response.get_headers()
    local header_data = nano.handleHeaders(headers)
    local status_code = kong.response.get_status()
    local content_length = tonumber(headers["content-length"]) or 0

    local verdict, response = nano.send_response_headers(session_id, session_data, header_data, status_code, content_length)
    if verdict == nano.AttachmentVerdict.DROP then
        kong.ctx.plugin.blocked = true
        nano.fini_session(session_data)
        nano.cleanup_all()
        return nano.handle_custom_response(session_data, response)
    end

    ctx.expect_body = not (status_code == 204 or status_code == 304 or (100 <= status_code and status_code < 200) or content_length == 0)
end

function NanoHandler.body_filter(conf)
    local ctx = kong.ctx.plugin
    if ctx.blocked then
        return
    end

    local session_id = ctx.session_id
    local session_data = ctx.session_data

    if not session_id or not session_data or ctx.session_finalized then
        return
    end

    -- Initialize chunk counter and timeout tracking on first call
    if not ctx.body_buffer_chunk then
        ctx.body_buffer_chunk = 0
        ctx.body_filter_start_time = ngx.now() * 1000
        ctx.num_body_filter_calls = 0
        ctx.last_chunk_hash = nil
    end
    
    ctx.num_body_filter_calls = ctx.num_body_filter_calls + 1

    local current_time = ngx.now() * 1000
    if current_time - ctx.body_filter_start_time > 150000 then
        kong.log.warn("body_filter timeout exceeded (2.5 minutes), failing open")
        
        if not ctx.session_finalized then
            nano.fini_session(session_data)
            nano.cleanup_all()
            ctx.session_finalized = true
        end
        
        return
    end

    local chunk = ngx.arg[1]
    local eof = ngx.arg[2]
    local full_body = kong.response.get_raw_body()
    local is_streaming = (full_body == nil and chunk ~= nil)
    
    -- Return early for empty/nil chunks that aren't EOF
    if not eof and (not chunk or (type(chunk) == "string" and #chunk == 0)) and not full_body then
        kong.log.debug("Skipping empty chunk, call #", ctx.num_body_filter_calls)
        return
    end
    
    local chunk_size = chunk and type(chunk) == "string" and #chunk or 0
    kong.log.debug("body_filter call #", ctx.num_body_filter_calls, ", chunk size: ", chunk_size, ", eof: ", eof, ", sent: ", ctx.body_buffer_chunk, " chunks")
    
    if full_body and not ctx.body_seen then
        ctx.body_seen = true
        
        local ok, result = pcall(function()
            return {nano.send_body(session_id, session_data, full_body, nano.HttpChunkType.HTTP_RESPONSE_BODY)}
        end)
        
        if ok and result and result[1] then
            local verdict = result[1]
            local response = result[2]
            local modifications = result[3]

            if modifications then
                full_body = nano.handle_body_modifications(full_body, modifications, ctx.body_buffer_chunk)
                kong.response.set_raw_body(full_body)
            end

            ctx.body_buffer_chunk = ctx.body_buffer_chunk + 1

            if verdict == nano.AttachmentVerdict.DROP then
                nano.fini_session(session_data)
                ctx.session_finalized = true
                local custom_result = nano.handle_custom_response(session_data, response)
                nano.cleanup_all()
                return custom_result
            end
        else
            kong.log.warn("nano.send_body failed for in-memory body: ", result)
            ctx.body_buffer_chunk = ctx.body_buffer_chunk + 1
            ctx.failed_nano_send = true
        end
        
    elseif is_streaming and chunk and type(chunk) == "string" and #chunk > 0 then
        ctx.body_seen = true
        
        local chunk_hash = ngx.crc32_long(chunk)
        
        if chunk_hash == ctx.last_chunk_hash then
            kong.log.debug("Duplicate chunk detected (same hash as previous), skipping")
            return
        end
            
        local ok, result = pcall(function()
            return {nano.send_body(session_id, session_data, chunk, nano.HttpChunkType.HTTP_RESPONSE_BODY)}
        end)
        
        if ok and result and result[1] then
            ctx.last_chunk_hash = chunk_hash
            ctx.body_buffer_chunk = ctx.body_buffer_chunk + 1
            
            local verdict = result[1]
            local response = result[2]
            local modifications = result[3]

            if modifications then
                chunk = nano.handle_body_modifications(chunk, modifications, ctx.body_buffer_chunk)
                ngx.arg[1] = chunk
            end

            if verdict == nano.AttachmentVerdict.DROP then
                nano.fini_session(session_data)
                ctx.session_finalized = true
                local custom_result = nano.handle_custom_response(session_data, response)
                nano.cleanup_all()
                return custom_result
            end
        else
            -- Nano send failed - finalize session immediately and fail open
            kong.log.warn("nano.send_body failed, finalizing session and failing open: ", result)
            
            if not ctx.session_finalized then
                nano.fini_session(session_data)
                nano.cleanup_all()
                ctx.session_finalized = true
            end
            
            -- Pass chunk through uninspected
            return
        end
    end

    if eof or (ctx.expect_body == false and not ctx.body_seen) then
        if not ctx.session_finalized then
            local ok, result = pcall(function()
                return {nano.end_inspection(session_id, session_data, nano.HttpChunkType.HTTP_RESPONSE_END)}
            end)
            
            if ok and result and result[1] then
                local verdict = result[1]
                local response = result[2]
                
                if verdict == nano.AttachmentVerdict.DROP then
                    nano.fini_session(session_data)
                    ctx.session_finalized = true
                    ngx.arg[1] = nil
                    ngx.arg[2] = true
                    local custom_result = nano.handle_custom_response(session_data, response)
                    nano.cleanup_all()
                    return custom_result
                end
            else
                kong.log.warn("nano.end_inspection failed: ", result)
            end
            
            nano.fini_session(session_data)
            nano.cleanup_all()
            ctx.session_finalized = true
        end
    end
end

return NanoHandler