Configurazione delle funzionalità avanzate dei criteri di autorizzazione
Il criterio di autorizzazione di Cloud Service Mesh fornisce il controllo degli accessi a livello di mesh, spazio dei nomi e caricamento di lavoro per i tuoi carichi di lavoro nel mesh. Questa pagina descrive i dettagli sulla configurazione delle funzionalità avanzate dei criteri di autorizzazione di Cloud Service Mesh, tra cui la modalità di prova e la registrazione dei rifiuti. Le funzionalità descritte in questa pagina si presuppone che tu abbia familiarità con le nozioni di base i concetti relativi alle norme descritti in Panoramica dei criteri di autorizzazione.
Modalità dry run
Il criterio di autorizzazione di Cloud Service Mesh supporta la modalità di prova, che ti consente di verificare un criterio di autorizzazione con traffico di produzione reale senza applicarlo. La modalità di prova ti consente di comprendere meglio l'effetto di un criterio di autorizzazione prima di applicarlo. In questo modo si riduce il rischio di danneggiare generato da un criterio di autorizzazione non corretto.
Utilizza l'annotazione "istio.io/dry-run": "true"
nel criterio di autorizzazione per impostarlo sulla modalità di prova.
Esempio di modalità dry run
L'esempio seguente, deny-path-headers
, mostra
un criterio con l'annotazione dry-run
impostata su "true
. Il criterio di autorizzazione
rifiuta le richieste al percorso headers
e consente tutte le altre richieste.
apiVersion: security.istio.io/v1beta1
kind: AuthorizationPolicy
metadata:
name: deny-path-headers
annotations:
"istio.io/dry-run": "true"
spec:
selector:
matchLabels:
app: httpbin
action: DENY
rules:
- to:
- operation:
paths: ["/headers"]
Quando applichi un criterio di autorizzazione in modalità di prova, Cloud Service Mesh registra le risultato dell'applicazione forzata per Cloud Logging, ma non per applicare i criteri. La richiesta è sempre consentita e puoi controllare Explorer dei log per decidere se il criterio di autorizzazione funziona o meno come previsto.
Dettagli logging dry run
Dopo aver applicato un criterio di autorizzazione in modalità dry run, puoi vedere i risultati del criterio in Esplora log.
Vai a Esplora log. Nell'URL seguente, sostituisci
PROJECT_ID
con l'ID del tuo progetto:https://console.cloud.google.com/logs/query?project=PROJECT_ID
Nel campo Query Builder, inserisci una query per trovare il criterio di autorizzazione della modalità di prova. Nella query seguente, sostituisci
NAMESPACE
con il tuo spazio dei nomi:logName="projects/PROJECT_ID/logs/server-accesslog-stackdriver" labels.destination_namespace="NAMESPACE" labels.dry_run_result="AuthzDenied"
Fai clic su Esegui query.
Modifica l'intervallo di tempo in base alle tue esigenze.
Lo screenshot seguente mostra le etichette di prova nel log del traffico in Esplora log dopo l'applicazione del criterio deny-path-headers
di esempio:
La modalità di prova supporta i criteri di autorizzazione ALLOW
e DENY
, oltre ai
risultati della prova di Istio.
Cloud Service Mesh archivia i risultati della simulazione in Cloud Logging nei seguenti etichette:
- dry_run_result: il risultato della prova è "AuthzAllowed" o "AuthzDenied".
- dry_run_policy_name: lo spazio dei nomi e il nome del criterio di autorizzazione corrispondente che prende la decisione di prova.
- dry_run_policy_rule: l'indice della regola del criterio di autorizzazione corrispondente che prende la decisione relativa al dry run.
La tabella seguente mostra i dettagli registrati per un criterio di autorizzazione in modalità di prova:
Criterio di autorizzazione applicato in modalità di prova | Risultato della corrispondenza | Risultato dry run | Cloud Logging |
---|---|---|---|
Solo DENY criterio |
Senza corrispondenza | consentito | dry_run_result: "AuthzAllowed" |
Con corrispondenza | rifiutato | dry_run_result: "AuthzDenied" dry_run_policy_name: dry_run_policy_rule: |
|
Solo criterio ALLOW |
Senza corrispondenza | rifiutato | dry_run_result: "AuthzDenied" |
Con corrispondenza | consentito | dry_run_result: "AuthzAllowed" dry_run_policy_name: dry_run_policy_rule: |
|
Criterio sia ALLOW che DENY |
Nessuna corrispondenza | rifiutato | dry_run_result: "AuthzDenied" |
Solo norma DENY corrispondente |
rifiutato | dry_run_result: "AuthzDenied" dry_run_policy_name: dry_run_policy_rule: |
|
Corrisponde solo alla norma ALLOW |
consentito | dry_run_result: "AuthzAllowed" dry_run_policy_name: dry_run_policy_rule: |
|
Corrispondenza con entrambe le norme | rifiutato | dry_run_result: "AuthzDenied" dry_run_policy_name: dry_run_policy_rule: |
Quando hai la certezza del risultato della prova, puoi disattivare la modalità di prova utilizzando uno dei seguenti approcci:
Rimuovi completamente l'annotazione dry run. o
Modifica il valore dell'annotazione di prova in
false
.
Dopo aver applicato il criterio con la modalità dry run disabilitata, Cloud Service Mesh applica il criterio.
Log dei rifiuti
Il criterio di autorizzazione nega una richiesta se non è consentita dal criterio. Per i protocolli HTTP (incluso gRPC), la richiesta viene rifiutata con il codice di stato 403. Per i protocolli non HTTP, la connessione viene terminata direttamente. La Il log del traffico di Cloud Logging include informazioni aggiuntive utili per: a capire perché il traffico viene rifiutato. Ad esempio, il log indica quante richieste vengono rifiutate dal criterio di autorizzazione, il che può aiutarti a determinare quale regola del criterio ha causato il rifiuto rispetto ai rifiuti dell'applicazione di backend.
Nell'esempio seguente, l'annotazione dry-run
è impostata su "false
. Quando applichi il criterio di autorizzazione DENY
, Cloud Service Mesh lo applica.
apiVersion: security.istio.io/v1beta1
kind: AuthorizationPolicy
metadata:
name: deny-path-headers
annotations:
"istio.io/dry-run": "false"
spec:
selector:
matchLabels:
app: httpbin
action: DENY
rules:
- to:
- operation:
paths: ["/headers"]
Dopo aver applicato un criterio di autorizzazioneDENY
, puoi visualizzare i risultati del criterio in Esplora log.
Vai a Esplora log. Nel seguente URL, sostituisci
PROJECT_ID
con il tuo ID progetto:https://console.cloud.google.com/logs/query?project=PROJECT_ID
Nel campo Query-builder, inserisci una query per trovare
DENY
criterio di autorizzazione. Nella seguente query, sostituisciNAMESPACE
con il tuo spazio dei nomi:logName="projects/PROJECT_ID/logs/server-accesslog-stackdriver" labels.destination_namespace="NAMESPACE" labels.response_details="AuthzDenied"
Fai clic su Esegui query.
Modifica l'intervallo di tempo in base alle tue esigenze.
Il seguente screenshot mostra una voce di log in Esplora log dopo il
il criterio deny-path-headers
di esempio è stato applicato per applicare il criterio. Puoi capire che il criterio di autorizzazione è responsabile del codice 403 osservando le etichette:
Il log del traffico di Esplora log include le seguenti etichette per rifiuto dell'autorizzazione:
- response_details: viene impostato su "AuthzDenied" se il rifiuto è causato da un criterio di autorizzazione.
- policy_name: contiene lo spazio dei nomi e il nome del criterio
DENY
di autorizzazione che causa il rifiuto. Il valore è nel formato<Namespace>.<Name>
, ad esempiofoo.deny-path-headers
indica il criterio di autorizzazionedeny-path-headers
nello spazio dei nomifoo
. - policy_rule: contiene l'indice della regola all'interno della sezione criterio di autorizzazione che causa il rifiuto, ad esempio 0 indica che la prima regola all'interno del criterio.
Passaggi successivi
Per un elenco di tutti i criteri di autorizzazione nel service mesh:
kubectl get authorizationpolicy --all-namespaces
Se è in vigore un criterio di autorizzazione, puoi eliminarlo con
kubectl delete
:
kubectl delete authorizationpolicy -n NAMESPACE AUTH_POLICY_NAME
Per ulteriori informazioni su come ottenere il log del traffico, vedi Accesso ai log in Cloud Logging.