Este documento proporciona información sobre la función "Ver registros de auditoría"y su uso, especialmente a través de la herramienta Swagger.
"Ver registros de auditoría" ofrece la oportunidad de obtener los detalles del registro de auditoría del usuario actual.
Para empezar a obtener información, la función API debe estar activa en la cuenta del usuario y se debe generar un token.
Pasos para generar un token en una cuenta que ya tiene una función API activa
1. Navegue hasta la sección "Configuración de la API".
2. Haga clic en el enlace "haga clic aquí" para navegar a la sección "Sección de fichas de acceso personal".
3. Pulse el botón "Generar nuevo token".
4. Introduzca el nombre de la ficha y compruebe los permisos
5. Haga clic en el botón "Guardar token" botón
El token generado debe utilizarse para la autorización posterior en la herramienta Swagger. Es posible editar, revocar y eliminar los tokens generados.
¿Cómo utilizar la API para la sección "Ver registros de auditoría"?
Condiciones previas
- La función API está activa para la cuenta
- Ficha generada
- Permiso comprobado para el token generado - usuario: registros de auditoría
- Ficha del portador para la Autorización
Pasos para autorizar a un usuario a seguir utilizando la API para "Ver registros de auditoría" a través de Swagger
1. Navegue hasta la sección "Configuración de la API".
2. Haga clic en el enlace "Documentación de la API" para navegar a la sección Swagger
3. Haga clic en el botón "Autorizar".
4. Type Bearer en el modal abierto y deje un espacio después de él (ver captura de pantalla abajo)
5. Copie el token generado en la sección "Personal Access Tokens" (Configuración de la API >"click here link"> sección Personal Access Tokens>Copiar token)
6. Pegar el token copiado en el modal abierto después del portador
7. Haga clic en el botón "Autorizar".
8. Haga clic en el botón "Cerrar".
9. Después de la autorización exitosa, el botón se verá como en la captura de pantalla siguiente
10. Ahora el usuario está autorizado con éxito y puede empezar a utilizar la API a través de la herramienta Swagger.
Pasos para utilizar la API para "Ver registros de auditoría" a través de Swagger
PowerDMARC La documentación de la API proporciona instrucciones de la API para diferentes secciones de la plataforma.
Condiciones previas:
- Ficha generada
- Usuario autorizado (ver pasos anteriores) en el Swagger
Pasos para empezar a utilizar la API para "Ver registros de auditoría" a través de Swagger
1. Introduzca "Ver registros de auditoría" en el campo de búsqueda
2. Ampliar la información
3. Haga clic en el botón "Probar".
4. Ver Los registros de auditoría sólo se pueden filtrar por fecha (desde/hasta, el formato de la fecha es año/mes/día), excepto que el número de página y el número de elementos por página se pueden especificar en los parámetros
5. Especifique el número de elementos por página, el número de página y filtre por fecha (véase la captura de pantalla siguiente)
6. Haga clic en el botón "Ejecutar".
7. Verificar la información de la solicitud (Curl, URL de la solicitud) y de la respuesta (código de estado, cuerpo de la respuesta, cabeceras de la respuesta)
Posibles códigos de estado de la respuesta:
- El código de estado 200 en la respuesta significa que la solicitud ha sido gestionada con éxito y la información de respuesta está disponible para el usuario.
- 401 significa que el usuario no está autorizado (el token no se ha proporcionado, o no es válido)
- 403 significa que un usuario no tiene permiso para obtener el recurso solicitado (los permisos no se especifican al generar un nuevo token)
Espero que esta sesión de conocimiento le haya sido útil. Para disfrutar de una experiencia de correo electrónico más segura, comience a autenticar sus correos electrónicos con DMARC hoy mismo.
