Customized Access Control

Kitex provides a simple middleware builder that supports self-defined access control logic to reject requests under certain conditions.

Below is a simple example that randomly rejects 1% of all requests through self-defined access control logic:

package myaccesscontrol

import (

var errRejected = errors.New("1% rejected")

// Implements a judge function.
func reject1percent(ctx context.Context, request interface{}) (reason error) {
    if rand.Intn(100) == 0 {
        return errRejected // an error should be returned when a request is rejected
    return nil

var MyMiddleware = acl.NewACLMiddleware(reject1percent) // create the middleware

Then, you can enable this middleware with WithMiddleware(myaccesscontrol.MyMiddleware) at the creation of a client or a server.

Last modified September 12, 2023 : docs: fix wrong jwt example link (#777) (85f1f67)