Obtener registros de un usuario

Recupere los eventos de registro de un usuario específico.

Nota: Para obtener más información sobre todos los tipos de eventos posibles, sus respectivos acrónimos y descripciones, consulte Log Event Type Codes.

Para obtener más información sobre la lista de campos que se pueden usar en sort, consulte Searchable Fields.

Auth0 limita la cantidad de registros que se pueden devolver por criterios de búsqueda a 100 registros por solicitud. Además, solo puede paginar hasta 1000 resultados de búsqueda. Si supera este umbral, vuelva a definir la búsqueda.

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,
    )
}

import { ManagementClient } from "auth0";

async function main() {
    const client = new ManagementClient({
        token: "<token>",
    });
    await client.users.logs.list("id", {
        page: 1,
        perPage: 1,
        sort: "sort",
        includeTotals: true,
    });
}
main();

import { ManagementClient } from "auth0";

async function main() {
    const client = new ManagementClient({
        token: "<token>",
    });
    await client.users.logs.list("id", {
        page: 1,
        perPage: 1,
        sort: "sort",
        includeTotals: true,
    });
}
main();

curl --request GET \
  --url https://{tenantDomain}/api/v2/users/{id}/logs \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://{tenantDomain}/api/v2/users/{id}/logs"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenantDomain}/api/v2/users/{id}/logs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.get("https://{tenantDomain}/api/v2/users/{id}/logs")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenantDomain}/api/v2/users/{id}/logs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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>"
  }
]

Autorizaciones

bearerAuthoAuth2ClientCredentials

Authorization · string · header · requerido

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

Parámetros de ruta

id · string · requerido

ID del usuario cuyos registros se van a recuperar

Parámetros de consulta

page · integer

Índice de página de los resultados que se devolverán. La primera página es 0.

per_page · integer

Número de resultados por página. La paginación se desactiva si no se envía el parámetro.

Rango requerido: 1 <= x <= 100

sort · string

Campo por el cual ordenar. Use fieldname:1 para orden ascendente y fieldname:-1 para descendente.

include_totals · boolean

Devuelva los resultados dentro de un objeto que contenga el recuento total de resultados (true) o como un arreglo directo de resultados (false, valor predeterminado).

Respuesta

200

application/json

Logs recuperados correctamente.

object[]

object

audience · string

Audiencia de la API a la que se aplica el evento.

client_id · string · predeterminado: AaiyAPdpYdesoKnqjj8HJqRn4T5titww

ID del cliente (aplicación).

client_name · string · predeterminado: My application Name

Nombre del cliente (aplicación).

connection · string

Nombre de la conexión a la que se refiere el evento.

connection_id · string

ID de la conexión a la que se refiere el evento.

date · string object · predeterminado: 2016-02-23T19:57:29.532Z

Fecha en la que se produjo el evento, en formato ISO 8601.

description · string | null

Descripción de este evento.

details · object

Detalles adicionales útiles sobre este evento (la estructura depende del tipo de evento).

hostname · string · predeterminado: 190.257.209.19

Nombre de host al que se aplica el evento.

ip · string · predeterminado: 190.257.209.19

Dirección IP del origen del evento de registro.

isMobile · boolean

Indica si el cliente era un dispositivo móvil (true) o un equipo de escritorio, portátil o servidor (false).

location_info · object

Información sobre la ubicación que desencadenó este evento en función de la ip.

Show child attributes

log_id · string

ID único del evento.

scope · string · predeterminado: ""

Permisos de scope aplicados al evento.

security_context · object

Información sobre señales relacionadas con la seguridad.

Show child attributes

strategy · string

Nombre de la estrategia implicada en el evento.

strategy_type · string

Tipo de estrategia implicada en el evento.

type · string · predeterminado: sapi

Tipo de evento.

user_agent · string

Cadena de user agent del dispositivo cliente que provocó el evento.

user_id · string · predeterminado: auth0|56c75c4e42b6359e98374bc2

ID del usuario implicado en el evento.

user_name · string

Nombre del usuario implicado en el evento.