> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references/user/security/list-signin-events.md). # Enumerar eventos de inicio de sesión Mostrar los inicios de sesión recientes de este usuario y sus fallos ### Descripción Enumera los inicios de sesión de Entra ID de este usuario durante el número de días elegido, con aplicación, hora, resultado, aplicación cliente, dispositivo y ubicación. Los fallos se resumen por aplicación para que el soporte pueda ver dónde fallan los inicios de sesión, y los inicios de sesión fallidos también muestran la dirección IP. El informe puede enviarse por correo electrónico o proporcionarse mediante un enlace de descarga. ### Casos de uso comunes * Investiga qué aplicación genera fallos de inicio de sesión para un usuario específico y por qué, agrupados por código de error. * Acota los resultados con `ApplicationName` (coincidencia parcial) o `FailedSignInsOnly` cuando un usuario informa de problemas de acceso. * Exporta los datos de inicio de sesión a CSV o Excel para un análisis posterior cuando el número de eventos sea demasiado grande para leerlo en el portal. ### Comportamiento * Los datos de registro de inicio de sesión se obtienen del punto de conexión beta de Microsoft Graph, porque el filtrado del tipo de evento de inicio de sesión y la obtención de inicios de sesión no interactivos requieren propiedades exclusivas de beta (`signInEventTypes`, `authenticationRequirement`). * Los resultados se escriben en la **Datos de salida** pestaña del trabajo en cada ejecución: un resumen, el resumen por aplicación, los inicios de sesión fallidos y, a menos que solo se soliciten inicios de sesión fallidos, todos los inicios de sesión. La consola muestra los recuentos. * Los inicios de sesión no interactivos superan con creces a los interactivos; las tablas de inicios de sesión en la pestaña Datos de salida están limitadas a las 250 entradas más recientes, pero los archivos de informe exportados siempre contienen el conjunto completo de resultados. ### Licencia y permisos requeridos Leer los registros de inicio de sesión a través de la API de Microsoft Graph requiere una **licencia Entra ID P1 o P2** en el Tenant. Los Tenant sin ella reciben un error 403 de la consulta de registros de inicio de sesión incluso cuando se conceden todos los permisos de Microsoft Graph. Con P1/P2, los registros de inicio de sesión se conservan hasta 30 días; la retención de 7 días del nivel gratuito se aplica al portal de Entra, no a este runbook. Si la consulta del registro de inicio de sesión devuelve un 403 aunque `AuditLog.Read.All` se ha concedido y el Tenant tiene licencia, algunos Tenant además requieren `Directory.Read.All` en la API de informes de Entra. Concederlo es la solución conocida; no se declara de forma predeterminada porque otorga acceso de lectura a todos los objetos del directorio. ### Entrega del informe Los archivos del informe solo se generan cuando se selecciona un método de entrega a través de la **Entrega del informe** opción (correo electrónico y/o enlace de descarga). Con *Solo datos de salida* seleccionado, no se crean archivos de informe y el análisis de inicios de sesión se lee en la pestaña Datos de salida del trabajo en el portal RealmJoin. La entrega por correo electrónico y la generación del enlace de descarga son independientes y se pueden combinar. Para el enlace de descarga, los archivos del informe se cargan en la Storage Account de Azure configurada en la `RJReport.StorageAccount.*` configuración del Tenant, y se devuelven enlaces de descarga SAS con tiempo limitado. La carga al almacenamiento se autentica con la identidad administrada de la cuenta de Automation; esa identidad necesita el **Reader and Data Access** rol RBAC en la Storage Account de destino (esto es una asignación de RBAC de Azure, no un permiso de aplicación de Graph). ### Configuración relacionada con el envío de correo electrónico Enviar un informe por correo electrónico es opcional y solo ocurre cuando *Enviar también el informe por correo electrónico* o *Enviar también el informe por correo electrónico y enlace de descarga* se selecciona como entrega del informe; entonces se requiere un destinatario. La dirección del remitente se toma de la `RJReport.EmailSender` configuración del Tenant. Este runbook envía correos electrónicos usando la API de Microsoft Graph. Para enviar correos electrónicos a través de la API de Graph, debe configurar una dirección de correo electrónico existente en la personalización del runbook. Consulte la [documentación de configuración de informes de RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obtener detalles sobre todas las configuraciones disponibles. #### Marca del correo electrónico El correo electrónico del informe tiene en cuenta la opción opcional `RJReport.Branding.*` del Tenant: * **Imagen de encabezado y pie de página** – URL HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada una * **Enlace del pie de página** – destino de la imagen del pie de página * **Color de acento y de texto** – valores hexadecimales de 6 dígitos, p. ej. `#0052cc` Cuando estas configuraciones no están definidas, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen que no se puede descargar o validar, o un valor de color no válido, nunca impide el correo electrónico del informe; en su lugar se usa el valor predeterminado correspondiente. Instrucciones de configuración y requisitos de imagen: [Marca del correo electrónico](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional). ### Interpretación de los resultados Entra considera algunas interrupciones de inicio de sesión como errores (por ejemplo, 50140 "Keep me signed in", 50058 y 50076), por lo que aparecen como fallos y se incluyen en la tasa de fallos por aplicación. Comprueba el motivo del fallo antes de considerar una tasa de fallos alta como un problema real. Los códigos de error son códigos de error de inicio de sesión de Entra ID; consúltalos en . Los datos de registros de inicio de sesión suelen ir con un retraso de unos 15 minutos, pero algunos registros pueden tardar hasta 2 horas; un inicio de sesión muy reciente puede que aún no aparezca. Todas las marcas de tiempo se muestran en UTC. ### Ubicación Usuario → Seguridad → Listar eventos de inicio de sesión **Nombre completo del runbook** rjgit-user\_security\_list-signin-events ### Detalles | Propiedad | Valor | | ------------------ | ------------------------------------------------------------------------------------------------------------------ | | Versión | 1.1.0 | | Módulos requeridos |

RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
Az.Accounts (>= 5.5.2)

| | Programable | no | ### Permisos #### Permisos de aplicación * **Tipo**: Microsoft Graph * AuditLog.Read.All * *Lee los eventos de inicio de sesión de Entra ID del usuario de destino desde auditLogs/signIns (beta) para generar el informe* * User.Read.All * *Resuelve el usuario de destino para obtener id, userPrincipalName y displayName* * Mail.Send *(opcional — característica: informe por correo electrónico)* * *Envía el correo electrónico del informe de inicios de sesión con adjuntos CSV/XLSX mediante Send-RjRbReportEmail cuando se selecciona la entrega por correo electrónico* * Organization.Read.All *(opcional — característica: informe por correo electrónico)* * *Lee /organization para incluir el nombre del Tenant en el pie de página del correo electrónico del informe* #### Notas sobre permisos Azure Storage Account: rol 'Reader and Data Access' para la identidad administrada de la Automation Account en la Storage Account de destino - la carga recupera las claves de la cuenta mediante listKeys (solo necesario para las opciones de enlace de descarga) ### Parámetros #### Nombre de usuario Nombre principal de usuario del usuario sobre el que actúa el runbook. Lo establece el portal a partir del usuario seleccionado. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | verdadero | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### Días Cuántos días de registros de inicio de sesión incluir, de 1 a 30. | Propiedad | Valor | | ------------------------------ | -------------------------- | | Requerido | falso | | Valor predeterminado | 7 | | Tipo | Int32 | | Nombre para mostrar del portal | Días a revisar hacia atrás | #### SignInType Inicios de sesión interactivos del usuario, no interactivos de aplicaciones y tokens, o ambos. | Propiedad | Valor | | ------------------------------ | ------------------------ | | Requerido | falso | | Valor predeterminado | Solo interactivos | | Tipo | Cadena | | Nombre para mostrar del portal | Tipo de inicio de sesión | #### FailedSignInsOnly Oculta los inicios de sesión exitosos para que destaquen los fallos y sus motivos. | Propiedad | Valor | | ------------------------------ | --------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar del portal | ¿Solo inicios de sesión fallidos? | #### ApplicationName Muestra solo inicios de sesión en aplicaciones cuyo nombre contiene este texto. Déjelo vacío para todas las aplicaciones. | Propiedad | Valor | | ------------------------------ | ---------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar del portal | Filtro de aplicaciones | #### EmailFrom Dirección del remitente del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.EmailSender. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingHeaderImageUrl Imagen de encabezado del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Se toma de la configuración del Tenant RJReport.Branding.HeaderImageUrl; se usa el encabezado predeterminado de RealmJoin cuando está vacío. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingFooterImageUrl Imagen de pie de página del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Se toma de la configuración del Tenant RJReport.Branding.FooterImageUrl; se usa el pie de página predeterminado de RealmJoin cuando está vacío. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingFooterLink Enlace asociado a la imagen de pie de página del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.Branding.FooterLink; realmjoin.com se usa cuando está vacío. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingAccentColor Color de acento del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.AccentColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingTextColor Color de texto del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.TextColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### SendEmailReport Indica si el informe se envía por correo electrónico. Preconfigurado en la personalización del runbook. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### EmailTo Envía el informe a estas direcciones. Separe varias con comas; cada destinatario recibe un correo electrónico independiente. | Propiedad | Valor | | ------------------------------ | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar del portal | Dirección(es) de correo electrónico del destinatario | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### ReportFileFormat Entrega el informe como CSV, como un libro de Excel o ambos. | Propiedad | Valor | | ------------------------------ | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | CSV y XLSX | | Tipo | Cadena | | Nombre para mostrar del portal | Formato del archivo del informe | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | **Opciones del portal** | Opción del portal | Valor | | ----------------- | ---------- | | CSV y XLSX | CSV y XLSX | | Solo CSV | Solo CSV | | Solo XLSX | Solo XLSX | #### CreateDownloadLink También carga el informe y devuelve un enlace de descarga que expira después de unos días. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### ContainerName Contenedor de almacenamiento al que se cargan los archivos del informe. Se configura por runbook. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | user-signin-events | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### ResourceGroupName Grupo de recursos de la Storage Account para las cargas del informe. Obtenido de la configuración del Tenant RJReport.StorageAccount.ResourceGroup. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### StorageAccountName Storage Account para las cargas del informe. Obtenido de la configuración del Tenant RJReport.StorageAccount.StorageAccountName. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### LinkExpiryDays Número de días que un enlace de descarga permanece válido. Obtenido de la configuración del Tenant RJReport.StorageAccount.LinkExpiryDays. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | 6 | | Tipo | Int32 | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | [Volver a la vista general de referencia del runbook](/es/automatizacion/runbooks/runbook-references.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references/user/security/list-signin-events.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.