Go Academy · 강의

gRPC 인터셉터와 메타데이터

인증, 로깅 미들웨어 및 gRPC 메타데이터

gRPC 인터셉터와 메타데이터은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

인터셉터란 무엇입니까?

gRPC 인터셉터(미들웨어)는 RPC 처리기 전이나 후에 실행됩니다. 로깅, 인증 토큰 검증, 메트릭, 패닉 복구, 추적과 같은 공통 관심사를 추가합니다.

단항 서버 인터셉터

단항 서버 인터셉터는 처리기를 추가 로직으로 감쌉니다:

func LoggingInterceptor(ctx context.Context, req interface{}, info *grpc.UnaryServerInfo, handler grpc.UnaryHandler) (interface{}, error) {
    log.Printf("RPC: %s", info.FullMethod)
    resp, err := handler(ctx, req)
    log.Printf("done: %v", err)
    return resp, err
}

grpcSrv := grpc.NewServer(grpc.UnaryInterceptor(LoggingInterceptor))

스트림 서버 인터셉터

단항 인터셉터와 비슷하지만 스트림 처리기를 감쌉니다:

func StreamLogging(srv interface{}, ss grpc.ServerStream, info *grpc.StreamServerInfo, handler grpc.StreamHandler) error {
    log.Printf("stream: %s", info.FullMethod)
    return handler(srv, ss)
}

인터셉터 연결

grpc.ChainUnaryInterceptor(Go gRPC v1.38 이상)를 사용하면 여러 인터셉터를 순서대로 적용할 수 있습니다:

grpcSrv := grpc.NewServer(
    grpc.ChainUnaryInterceptor(LoggingInterceptor, AuthInterceptor, MetricsInterceptor),
)

클라이언트 인터셉터

클라이언트 측 단항 인터셉터는 나가는 호출을 감쌉니다. 인증 토큰, 재시도 또는 추적 헤더를 주입할 때 유용합니다:

conn, _ := grpc.NewClient(addr,
    grpc.WithUnaryInterceptor(ClientAuthInterceptor),
    grpc.WithTransportCredentials(insecure.NewCredentials()),
)

gRPC 메타데이터

메타데이터는 RPC와 함께 전송되는 키-값 쌍으로, HTTP 헤더와 비슷합니다. 클라이언트에서 metadata.New와 metadata.NewOutgoingContext를 사용합니다.

md := metadata.New(map[string]string{"authorization": "Bearer " + token})
ctx := metadata.NewOutgoingContext(context.Background(), md)

서버에서 메타데이터 읽기

metadata.FromIncomingContext로 수신 메타데이터를 추출합니다:

md, ok := metadata.FromIncomingContext(ctx)
if !ok { return nil, status.Error(codes.Unauthenticated, "no metadata") }
token := md["authorization"]

서버에서 메타데이터 전송

grpc.SetHeader와 grpc.SetTrailer를 사용해 서버에서 응답 헤더와 트레일러를 전송합니다:

grpc.SetHeader(ctx, metadata.Pairs("x-request-id", requestID))

go-grpc-middleware

github.com/grpc-ecosystem/go-grpc-middleware/v2 라이브러리는 복구, 로깅(zap/logrus), 인증 등 바로 사용할 수 있는 인터셉터를 제공합니다.

인증 인터셉터 패턴

인터셉터에서 토큰을 추출하고 검증한 다음, 하위 처리기가 사용할 수 있도록 사용자를 컨텍스트에 연결합니다:

func AuthInterceptor(ctx context.Context, req interface{}, info *grpc.UnaryServerInfo, handler grpc.UnaryHandler) (interface{}, error) {
    md, _ := metadata.FromIncomingContext(ctx)
    if !validateToken(md["authorization"]) {
        return nil, status.Error(codes.Unauthenticated, "invalid token")
    }
    return handler(ctx, req)
}

패닉 복구 인터셉터

처리기를 감싸 패닉을 복구하고, 프로그램이 중단되는 대신 Internal 오류를 반환합니다:

defer func() {
    if r := recover(); r != nil {
        err = status.Errorf(codes.Internal, "panic: %v", r)
    }
}()

빠른 확인

gRPC 클라이언트와 서버 사이에 인증 토큰을 어떻게 전달합니까?

복습: gRPC 인터셉터와 메타데이터

핵심 내용:

단항 인터셉터: func(ctx, req, info, handler) (resp, error)
여러 인터셉터에는 grpc.ChainUnaryInterceptor 사용
메타데이터는 키-값 쌍이며 HTTP 헤더와 비슷합니다
인증 인터셉터: 메타데이터 추출 → 검증 → 사용자를 컨텍스트에 추가

자주 묻는 질문

“gRPC 인터셉터와 메타데이터” 강의는 무료인가요?

네 — “gRPC 인터셉터와 메타데이터” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“gRPC 인터셉터와 메타데이터”에서 뭘 배우나요?

인증, 로깅 미들웨어 및 gRPC 메타데이터 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Go Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“gRPC 인터셉터와 메타데이터” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Go Academy(으)로 돌아가기