Go Academy · leksjon

gRPC-interceptorer og metadata

Autentisering, logging-middleware og gRPC-metadata

Leksjon 4 av 413 trinn

gRPC-interceptorer og metadata er en gratis leksjon i Go Academy på CoddyKit. Dette er leksjon 4 av 4. Du kan lese valgfritt 3 leksjoner fra denne læringsstien gratis i sin helhet – deretter låser CoddyKit PRO opp alle leksjoner, samt praktisk øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Den er en del av læringsløpet i Go Academy, og fremdriften din synkroniseres mellom nettet og CoddyKit-appen. Kurset i Go Academy inneholder totalt 4 leksjoner.

Hva er interceptors?

gRPC-interceptors (middleware) kjøres før eller etter RPC-håndterere. De legger til tverrgående funksjonalitet som logging, validering av autentiseringstokener, måledata, gjenoppretting etter panikk og sporing.

Unary-serverinterceptor

En unary-serverinterceptor pakker inn håndtereren med ekstra logikk:

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))

Stream-serverinterceptor

Dette ligner på unary, men pakker inn strømmingshåndtereren:

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

Kjede interceptors

Bruk grpc.ChainUnaryInterceptor (Go gRPC v1.38+) for å bruke flere interceptors i riktig rekkefølge:

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

Klientinterceptors

Unary-interceptors på klientsiden pakker inn utgående kall – nyttig for å sette inn autentiseringstokener, nye forsøk eller sporingsheadere:

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

gRPC-metadata

Metadata er nøkkel-verdi-par som sendes sammen med en RPC, tilsvarende HTTP-headere. Bruk metadata.New og metadata.NewOutgoingContext på klienten.

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

Lese metadata på serveren

Hent innkommende metadata med metadata.FromIncomingContext:

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

Sende metadata fra serveren

Send svarheadere og trailers fra serveren med grpc.SetHeader og grpc.SetTrailer:

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

go-grpc-middleware

Biblioteket github.com/grpc-ecosystem/go-grpc-middleware/v2 tilbyr ferdige interceptors: recovery, logging (zap/logrus), auth og mer.

Mønster for auth-interceptor

Hent ut og valider et token i en interceptor, og knytt brukeren til context-en for underliggende håndterere:

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)
}

Interceptor for gjenoppretting etter panikk

Pakk inn håndterere for å gjenopprette etter panikk og returnere en Internal-feil i stedet for at programmet krasjer:

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

Kort sjekk

Hvordan sender du autentiseringstokener mellom en gRPC-klient og -server?

Besvar den i den interaktive leksjonen

Oppsummering: gRPC-interceptors og metadata

Viktige punkter:

Unary-interceptor: func(ctx, req, info, handler) (resp, error)
grpc.ChainUnaryInterceptor for flere interceptors
Metadata er nøkkel-verdi-par, tilsvarende HTTP-headere
Auth-interceptor: hent ut metadata → valider → legg brukeren til i context

Gratis å komme i gang

Lær deg Go med en AI-veileder – gratis

Skriv og kjør ekte kode i nettleseren, få umiddelbar hjelp fra en AI-veileder som er tilgjengelig døgnet rundt, og fortsett der du slapp – på nettet eller i appen.

Kurs: 51
Leksjoner: 203

Start læringen gratis Se hele kurset

Ofte stilte spørsmål

Er leksjonen «gRPC-interceptorer og metadata» gratis?

Ja – du kan lese valgfritt 3 av leksjonene i læringsstien Go Academy, inkludert «gRPC-interceptorer og metadata», gratis i sin helhet her på nettet. Deretter låser CoddyKit PRO opp alle leksjoner, samt interaktiv øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Kurset i Go Academy inneholder totalt 4 leksjoner.

Hva lærer jeg i «gRPC-interceptorer og metadata»?

Autentisering, logging-middleware og gRPC-metadata Du øver på Go Academy med praktisk kode som du kjører direkte i nettleseren, mens en AI-veileder som er tilgjengelig døgnet rundt, svarer på spørsmålene dine mens du jobber deg gjennom leksjonen.

Trenger jeg erfaring for å begynne med Go Academy?

Ingen tidligere erfaring er nødvendig. Go Academy på CoddyKit er lagt opp for både nybegynnere og viderekomne, så De kan begynne her eller helt fra start og lære i Deres eget tempo. Dette er leksjon 4 av 4.

Hvor lang tid tar leksjonen «gRPC-interceptorer og metadata»?

De fleste CoddyKit-leksjoner tar omtrent 5–10 minutter. Hver leksjon er kort og interaktiv, slik at De gjør jevne fremskritt og kan fortsette akkurat der De slapp – både på nettet og i appen.

Kan jeg skrive og kjøre kode i denne Go Academy-leksjonen?

Ja. Alle Go Academy-leksjoner har en innebygd kodeeditor, slik at De kan skrive og kjøre ekte kode direkte i nettleseren og få umiddelbar tilbakemelding fra AI – uten lokal konfigurering.

Alle leksjonene i dette kurset

← Tilbake til Go Academy