Intergiciel Gin : authentification et journalisation
Écrire et enregistrer des intergiciels Gin
Intergiciel Gin : authentification et journalisation est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Go Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Go Academy comprend 4 leçons au total.
Signature d’un intergiciel Gin
Un intergiciel Gin est un gin.HandlerFunc qui appelle c.Next() pour transmettre le contrôle au gestionnaire suivant, ou c.Abort() pour arrêter la chaîne.
func MyMiddleware() gin.HandlerFunc {
return func(c *gin.Context) {
// before handler
c.Next()
// after handler
}
}Appliquer un intergiciel globalement
Utilisez r.Use pour appliquer un intergiciel à toutes les routes :
r := gin.New()
r.Use(gin.Logger())
r.Use(gin.Recovery())Intergiciel de journalisation
Le gin.Logger() intégré à Gin journalise la méthode, le chemin, le code d’état et la latence. Pour une journalisation structurée, remplacez-le par un intergiciel personnalisé utilisant zap ou slog :
func ZapLogger(logger *zap.Logger) gin.HandlerFunc {
return func(c *gin.Context) {
start := time.Now()
c.Next()
logger.Info("request",
zap.String("method", c.Request.Method),
zap.String("path", c.FullPath()),
zap.Int("status", c.Writer.Status()),
zap.Duration("latency", time.Since(start)),
)
}
}Intergiciel d’authentification
Validez un JWT ou une clé d’API dans un intergiciel et interrompez le traitement avec le code 401 si la valeur est invalide :
func AuthRequired() gin.HandlerFunc {
return func(c *gin.Context) {
token := c.GetHeader("Authorization")
claims, err := validateJWT(token)
if err != nil {
c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "invalid token"})
return
}
c.Set("user", claims)
c.Next()
}
}Transmettre des données via le contexte
Stockez des données avec c.Set("key", value) et récupérez-les dans les gestionnaires avec c.Get("key") ou avec des assistants typés comme c.MustGet :
user, _ := c.Get("user")
claims := user.(*Claims)Intergiciel de récupération
gin.Recovery() intercepte les paniques et renvoie une réponse 500. Personnalisez-le pour journaliser la trace de la pile ou l’envoyer à un service de suivi des erreurs :
r.Use(gin.CustomRecovery(func(c *gin.Context, recovered any) {
log.Printf("panic: %v", recovered)
c.AbortWithStatusJSON(500, gin.H{"error": "internal server error"})
}))Intergiciel CORS
Ajoutez des en-têtes CORS avec github.com/gin-contrib/cors :
r.Use(cors.New(cors.Config{
AllowOrigins: []string{"https://example.com"},
AllowMethods: []string{"GET", "POST", "PUT"},
AllowHeaders: []string{"Authorization", "Content-Type"},
AllowCredentials: true,
}))Intergiciel de limitation du débit
Utilisez un seau de jetons par adresse IP avec golang.org/x/time/rate dans un intergiciel pour limiter le débit des requêtes.
Intergiciel d’identifiant de requête
Générez un identifiant de requête unique pour chaque requête et ajoutez-le au contexte ainsi qu’à l’en-tête de réponse :
func RequestID() gin.HandlerFunc {
return func(c *gin.Context) {
id := uuid.New().String()
c.Set("requestID", id)
c.Header("X-Request-ID", id)
c.Next()
}
}Intergiciel au niveau d’un groupe
Appliquez un intergiciel à un groupe précis plutôt qu’à l’ensemble des routes :
admin := r.Group("/admin")
admin.Use(AuthRequired(), AdminOnly())
admin.GET("/users", listUsers)Ordre d’exécution des intergiciels
Les intergiciels s’exécutent dans l’ordre d’enregistrement avant le gestionnaire, puis dans l’ordre inverse après le retour de c.Next(). Imaginez une structure en oignon : chaque couche enveloppe la suivante.
Vérification rapide
Comment un intergiciel Gin empêche-t-il une requête d’atteindre le gestionnaire ?
Récapitulatif : intergiciels Gin
Points clés :
- HandlerFunc renvoie gin.HandlerFunc ; appelez c.Next() pour continuer
- c.Set/c.Get permettent de transmettre des données dans la chaîne
- c.AbortWithStatusJSON arrête la chaîne et envoie une erreur
- Appliquez-les globalement avec r.Use ou par groupe avec group.Use
Questions Fréquemment Posées
La leçon « Intergiciel Gin : authentification et journalisation » est-elle gratuite ?
Oui — le texte complet de « Intergiciel Gin : authentification et journalisation » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Go Academy, passe à CoddyKit PRO. Le cours Go Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Intergiciel Gin : authentification et journalisation » ?
Écrire et enregistrer des intergiciels Gin Tu pratiques Go Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Go Academy ?
Aucune expérience préalable n'est requise. Go Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.
Combien de temps prend la leçon « Intergiciel Gin : authentification et journalisation » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Go Academy ?
Oui. Chaque leçon Go Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Routeur Gin et groupes de routes
- Association et validation des requêtes
- Assistants de réponse et codes d’état
- Intergiciel Gin : authentification et journalisation