Récupérer les journaux d’un utilisateur

Récupérez les événements du journal d’un utilisateur précis.

Remarque : pour en savoir plus sur tous les types d’événement possibles, leurs acronymes respectifs et leurs descriptions, consultez Log Event Type Codes.

Pour en savoir plus sur la liste des champs qui peuvent être utilisés dans sort, consultez Searchable Fields.

Auth0 limite le nombre de logs que vous pouvez renvoyer selon des critères de recherche à 100 logs par requête. De plus, vous ne pouvez paginer que jusqu’à 1 000 résultats de recherche. Si vous dépassez ce seuil, veuillez redéfinir votre recherche.

GET https://{tenantDomain}/api/v2/users/{id}/logs

Go

Go

package example

import (
    context "context"

    management "github.com/auth0/go-auth0/management/management"
    client "github.com/auth0/go-auth0/management/management/client"
    option "github.com/auth0/go-auth0/management/management/option"
    users "github.com/auth0/go-auth0/management/management/users"
)

func do() {
    client := client.NewClient(
        option.WithToken(
            "<token>",
        ),
    )
    request := &users.ListUserLogsRequestParameters{
        Page: management.Int(
            1,
        ),
        PerPage: management.Int(
            1,
        ),
        Sort: management.String(
            "sort",
        ),
        IncludeTotals: management.Bool(
            true,
        ),
    }
    client.Users.Logs.List(
        context.TODO(),
        "id",
        request,
    )
}

200

[
  {
    "audience": "<string>",
    "client_id": "AaiyAPdpYdesoKnqjj8HJqRn4T5titww",
    "client_name": "My application Name",
    "connection": "<string>",
    "connection_id": "<string>",
    "date": "2016-02-23T19:57:29.532Z",
    "description": "<string>",
    "details": {},
    "hostname": "190.257.209.19",
    "ip": "190.257.209.19",
    "isMobile": true,
    "location_info": {
      "city_name": "<string>",
      "continent_code": "<string>",
      "country_code": "<string>",
      "country_code3": "<string>",
      "country_name": "<string>",
      "latitude": 123,
      "longitude": 123,
      "time_zone": "<string>"
    },
    "log_id": "<string>",
    "scope": "",
    "security_context": {
      "ja3": "<string>",
      "ja4": "<string>"
    },
    "strategy": "<string>",
    "strategy_type": "<string>",
    "type": "sapi",
    "user_agent": "<string>",
    "user_id": "auth0|56c75c4e42b6359e98374bc2",
    "user_name": "<string>"
  }
]

Autorisations

bearerAuthoAuth2ClientCredentials

Authorization · string · header · requis

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Paramètres de chemin

id · string · requis

ID de l’utilisateur dont les logs doivent être récupérés

Paramètres de requête

page · integer

Indice de page des résultats à renvoyer. La première page est 0.

per_page · integer

Nombre de résultats par page. La pagination est désactivée si le paramètre n’est pas envoyé.

Plage requise: 1 <= x <= 100

sort · string

Champ de tri. Utilisez fieldname:1 pour l’ordre croissant et fieldname:-1 pour l’ordre décroissant.

include_totals · boolean

Renvoyer les résultats dans un objet qui contient le nombre total de résultats (true) ou sous forme de tableau direct de résultats (false, valeur par défaut).

Réponse

200

application/json

Logs récupérés avec succès.

object[]

object

audience · string

Audience API à laquelle l’événement s’applique.

client_id · string · défaut: AaiyAPdpYdesoKnqjj8HJqRn4T5titww

ID de l’application.

client_name · string · défaut: My application Name

Nom de l’application.

connection · string

Nom de la connexion à laquelle l’événement se rapporte.

connection_id · string

ID de la connexion à laquelle l’événement se rapporte.

date · string object · défaut: 2016-02-23T19:57:29.532Z

Date à laquelle l’événement s’est produit, au format ISO 8601.

description · string | null

Description de cet événement.

details · object

Détails supplémentaires utiles sur cet événement (la structure dépend du type d’événement).

hostname · string · défaut: 190.257.209.19

Nom d’hôte auquel l’événement s’applique.

ip · string · défaut: 190.257.209.19

Adresse IP de la source de l’événement du journal.

isMobile · boolean

Indique si l’application était un appareil mobile (true) ou un ordinateur de bureau, portable ou serveur (false).

location_info · object

Informations sur l’emplacement à l’origine de cet événement, selon l’ip.

Show child attributes

log_id · string

ID unique de l’événement.

scope · string · défaut: ""

Permissions de scope appliquées à l’événement.

security_context · object

Informations sur les signaux liés à la sécurité.

Show child attributes

strategy · string

Nom de la stratégie impliquée dans l’événement.

strategy_type · string

Type de stratégie impliquée dans l’événement.

type · string · défaut: sapi

Type d’événement.

user_agent · string

Chaîne de l’agent utilisateur provenant de l’appareil client à l’origine de l’événement.

user_id · string · défaut: auth0|56c75c4e42b6359e98374bc2

ID de l’utilisateur impliqué dans l’événement.

user_name · string

Nom de l’utilisateur impliqué dans l’événement.