개요

Iris Body Limit 미들웨어는 Iris 웹 애플리케이션에서 들어오는 요청 본문의 크기를 제어하기 위한 강력한 도구입니다. 요청 본문 크기에 제한을 설정하면 클라이언트가 잠재적으로 서버를 압도하거나 DoS(서비스 거부) 공격을 일으킬 수 있는 지나치게 큰 페이로드를 보내는 것을 방지할 수 있습니다. 이 미들웨어는 파일 업로드, JSON 페이로드 또는 크기가 크게 다를 수 있는 기타 모든 유형의 데이터를 처리하는 애플리케이션에 특히 유용합니다.

Body Limit 미들웨어를 사용하는 이유는 무엇입니까?

보안

Body Limit 미들웨어를 사용하는 주요 이유 중 하나는 애플리케이션의 보안을 강화하는 것입니다. 들어오는 요청 본문의 크기를 제한하면 공격자가 서버 리소스를 고갈시키기 위해 대규모 페이로드를 보내는 DoS 공격의 위험을 완화할 수 있습니다.

성능

요청 본문의 크기를 제한하면 애플리케이션 성능도 향상될 수 있습니다. 대용량 페이로드는 상당한 양의 메모리와 처리 능력을 소비하여 서버 속도를 저하시키고 사용자 경험에 영향을 줄 수 있습니다. 합리적인 한도를 설정하면 서버의 응답성과 효율성을 유지할 수 있습니다.

자원 관리

파일 업로드 또는 대규모 JSON 페이로드를 처리하는 애플리케이션에서는 리소스를 효과적으로 관리하는 것이 필수적입니다. 본문 제한을 설정하면 클라이언트가 지나치게 큰 파일을 업로드하거나 서버 리소스에 부담을 줄 수 있는 대용량 JSON 개체를 보내는 것을 방지할 수 있습니다.

설치

bodylimit 미들웨어를 사용하려면 Iris 애플리케이션에서 이를 가져와야 합니다.

import "github.com/kataras/iris/v12/middleware/bodylimit"

용법

기본 설정

바디리미트 미들웨어를 사용하기 위해서는 아이리스 어플리케이션을 생성하고 미들웨어를 등록해야 합니다. 다음은 2MB 제한으로 미들웨어를 설정하는 방법의 예입니다.

package main

import (
    "github.com/kataras/iris/v12"
    "github.com/kataras/iris/v12/middleware/bodylimit"
)

func main() {
    app := iris.New()
    app.Use(bodylimit.New(2 * iris.MB)) // set the limit to 2 MB.

    handler := func(ctx iris.Context) {
        body, err := ctx.Body()
        if err != nil {
            ctx.StopWithPlainError(iris.StatusInternalServerError, err)
            return
        }

        ctx.Write(body) // write the request body back to the client.
    }

    app.Post("/", handler)
    app.Listen(":8080")
}

설명

• Limit: bodylimit.New 함수는 요청 본문의 최대 크기(바이트)인 단일 매개변수를 사용합니다. 위의 예에서는 제한이 10바이트로 설정되어 있습니다.
• 핸들러: 핸들러는 요청 본문을 읽고 이를 응답에 다시 씁니다. 요청 본문이 제한을 초과하는 경우 미들웨어는 요청을 중지하고 413 요청 엔터티가 너무 큼 상태를 반환합니다.
• 본문 제한 미들웨어는 sync.Pool을 사용하여 요청 본문을 읽고 크기 제한을 적용하는 데 사용되는 Reader 인스턴스를 관리합니다. 이 접근 방식은 효율적인 메모리 사용을 보장하고 각 요청에 대해 새 Reader 인스턴스를 생성하는 오버헤드를 줄입니다.

BodyLimit 미들웨어를 사용한 테스트 핸들러

BodyLimit 미들웨어를 사용하는 핸들러를 테스트하려면 Iris에서 제공하는 httptest 패키지를 사용할 수 있습니다. 다음은 핸들러를 테스트하는 방법의 예입니다.

package main_test

import (
    "testing"

    "github.com/kataras/iris/v12"
    "github.com/kataras/iris/v12/httptest"
    "github.com/kataras/iris/v12/middleware/bodylimit"
)

func TestBodyLimit(t *testing.T) {
    limit := int64(10) // set the limit to 10 bytes for the shake of the test.

    handler := func(ctx iris.Context) {
        body, err := ctx.Body()
        if err != nil {
            ctx.StopWithPlainError(iris.StatusInternalServerError, err)
            return
        }
        ctx.Write(body)
    }

    app := iris.New()
    app.Use(bodylimit.New(limit))
    app.Post("/", handler)

    e := httptest.New(t, app)

    // Test with a body that is smaller than the limit.
    e.POST("/").WithText("123456789").Expect().Status(iris.StatusOK).Body().IsEqual("123456789")

    // Test with a body that is equal to the limit.
    e.POST("/").WithText("1234567890").Expect().Status(iris.StatusOK).Body().IsEqual("1234567890")

    // Test with a body that is bigger than the limit.
    e.POST("/").WithText("12345678910").Expect().Status(iris.StatusRequestEntityTooLarge)
}

결론

Iris Body Limit 미들웨어는 Iris 웹 애플리케이션에서 들어오는 요청 본문의 크기를 제어하는 ​​간단하면서도 효과적인 방법을 제공합니다. 요청 본문 크기에 대한 제한을 설정하면 애플리케이션의 보안, 성능 및 리소스 관리를 강화할 수 있습니다. 쉬운 통합과 고급 기능을 갖춘 이 미들웨어는 모든 Iris 개발자에게 유용한 도구입니다.