Comment activer ou désactiver le mode de surveillance pour les règles de Tenant Access Control List

Vérifiez l’effet qu’aurait une règle sur le trafic entrant sans modifier le comportement actuel du Tenant ACL en activant le mode de surveillance.

Lorsqu’une règle est en mode de surveillance, le Tenant ACL évalue cette règle et génère un événement de journal du tenant, mais n’exécute pas l’action de la règle et n’interrompt pas l’évaluation des règles et des listes suivantes.

Pour activer le mode de surveillance, définissez la propriété log de l’action de la règle sur true :

Management API

Effectuez une requête vers le point de terminaison de la Management API Partial update for an access control list avec le corps suivant :

Management API request body

{
  "rule": {
    "action": {
      "log": true
    },
    "scope": "authentication"
  }
}

Go SDK

package main

import (
	"context"
	"log"

	"github.com/auth0/go-auth0"
	"github.com/auth0/go-auth0/management"
)

func main() {
	mgmt, err := management.New("{yourDomain}", management.WithClientCredentials("{yourClientId}", "{yourClientSecret}"))
	if err != nil {
		log.Fatal(err)
	}

	networkACL := &management.NetworkACL{
		Rule: &management.NetworkACLRule{
			Action: &management.NetworkACLRuleAction{
				Log: auth0.Bool(true),
			},
			Scope: auth0.String("authentication"),
		},
	}

	err = mgmt.NetworkACL.Patch(context.Background(), "{yourTenantAclRuleId}", networkACL)
	if err != nil {
		log.Fatal(err)
	}
	log.Println("Network ACL has been updated to enable monitoring mode")

Node SDK

const updateNetworkAclPayload: Management.UpdateNetworkAclRequestContent = {
  rule: {
    action: {
      log: true,
    },
    scope: "authentication"
  }
};

const updateNetworkAcl = await client.networkAcls.update("{yourTenantAclRuleId}", updateNetworkAclPayload);

Terraform

Dans le bloc de ressource, sous rule.action, définissez log sur true :

resource "auth0_network_acl" "example_acl" {
    description = "Example ACL"
    active = true
    priority = 1
    rule {
        action {
            block = true
            log = true
        }
        scope = "authentication"
        match {
          hostnames = ["example.com"]
        }
    }
}

Deploy CLI

exampleACLs:
  - description: Example ACL
    active: true
    priority: 1
    rule:
      action:
        block: true
        log: true
      match:
        hostnames:
          - "example.com"
      scope: authentication

Auth0 CLI

auth0 network-acl update {yourTenantAclRuleId} --action log

Vous pouvez désactiver le mode de surveillance en définissant de la même manière la propriété log sur false.