Functions

Funzioni nei matcher

Puoi anche specificare funzioni in un matcher per renderlo più potente. Puoi utilizzare funzioni integrate o specificare la tua funzione. Le funzioni integrate di corrispondenza delle chiavi hanno il seguente formato:

bool function_name(string url, string pattern)

Restituiscono un booleano che indica se l'url corrisponde al pattern.

Le funzioni integrate supportate sono:

Funzione	url	pattern	Esempio
keyMatch	un percorso URL come /alice_data/resource1	un percorso URL o un pattern * come /alice_data/*	keymatch_model.conf/keymatch_policy.csv
keyMatch2	un percorso URL come /alice_data/resource1	un percorso URL o un pattern : come /alice_data/:resource	keymatch2_model.conf/keymatch2_policy.csv
keyMatch3	un percorso URL come /alice_data/resource1	un percorso URL o un pattern {} come /alice_data/{resource}	https://github.com/casbin/casbin/blob/277c1a2b85698272f764d71a94d2595a8d425915/util/builtin_operators_test.go#L171-L196
keyMatch4	un percorso URL come /alice_data/123/book/123	un percorso URL o un pattern {} come /alice_data/{id}/book/{id}	https://github.com/casbin/casbin/blob/277c1a2b85698272f764d71a94d2595a8d425915/util/builtin_operators_test.go#L208-L222
keyMatch5	un percorso URL come /alice_data/123/?status=1	un percorso URL, un pattern {} o * come /alice_data/{id}/*	https://github.com/casbin/casbin/blob/1cde2646d10ad1190c0d784c3a1c0e1ace1b5bc9/util/builtin_operators_test.go#L485-L526
regexMatch	qualsiasi stringa	un modello di espressione regolare	keymatch_model.conf/keymatch_policy.csv
ipMatch	un indirizzo IP come 192.168.2.123	un indirizzo IP o un CIDR come 192.168.2.0/24	ipmatch_model.conf/ipmatch_policy.csv
globMatch	un percorso simile a /alice_data/resource1	un pattern glob come /alice_data/*	https://github.com/casbin/casbin/blob/277c1a2b85698272f764d71a94d2595a8d425915/util/builtin_operators_test.go#L426-L466

Per le funzioni di recupero delle chiavi, di solito accettano tre parametri (ad eccezione di keyGet):

bool function_name(string url, string pattern, string key_name)

Restituiranno il valore della chiave key_name se corrisponde al pattern e restituiranno "" se non viene trovata alcuna corrispondenza.

Ad esempio, KeyGet2("/resource1/action", "/:res/action", "res") restituirà "resource1", e KeyGet3("/resource1_admin/action", "/{res}_admin/*", "res") restituirà "resource1". Per quanto riguarda KeyGet, che accetta due parametri, KeyGet("/resource1/action", "/*) restituirà "resource1/action".

Funzione	url	pattern	key_name	esempio
keyGet	un percorso URL come /proj/resource1	un percorso URL o un pattern * come /proj/*	\	keyget_model.conf/keymatch_policy.csv
keyGet2	un percorso URL come /proj/resource1	un percorso URL o un pattern : come /prooj/:resource	nome della chiave specificato nel pattern	keyget2_model.conf/keymatch2_policy.csv
keyGet3	un percorso URL come /proj/res3_admin/	un percorso URL o un pattern {} come /proj/{resource}_admin/*	nome della chiave specificato nel pattern	https://github.com/casbin/casbin/blob/7bd496f94f5a2739a392d333a9aaaa10ae397673/util/builtin_operators_test.go#L209-L247

Vedi i dettagli per le funzioni sopra menzionate su: https://github.com/casbin/casbin/blob/master/util/builtin_operators_test.go

Come aggiungere una funzione personalizzata

Prima, prepara la tua funzione. Prende diversi parametri e restituisce un bool:

func KeyMatch(key1 string, key2 string) bool {
    i := strings.Index(key2, "*")
    if i == -1 {
        return key1 == key2
    }

    if len(key1) > i {
        return key1[:i] == key2[:i]
    }
    return key1 == key2[:i]
}

Quindi, avvolgilo con i tipi interface{}:

func KeyMatchFunc(args ...interface{}) (interface{}, error) {
    name1 := args[0].(string)
    name2 := args[1].(string)

    return (bool)(KeyMatch(name1, name2)), nil
}

Infine, registra la funzione all'enforcer di Casbin:

e.AddFunction("my_func", KeyMatchFunc)

Ora, puoi utilizzare la funzione nel tuo modello CONF in questo modo:

[matchers]
m = r.sub == p.sub && my_func(r.obj, p.obj) && r.act == p.act