> 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/pt/automatizacao/runbooks/runbook-references/user/security/list-signin-events.md). # Listar eventos de início de sessão Mostrar os inícios de sessão recentes deste utilizador e as respetivas falhas ### Descrição Lista os inícios de sessão do Entra ID deste utilizador durante o número de dias escolhido, com aplicação, hora, resultado, aplicação cliente, dispositivo e localização. As falhas são somadas por aplicação para que o suporte possa ver onde os inícios de sessão correm mal, e os inícios de sessão com falha também mostram o endereço IP. O relatório pode ser enviado por e-mail ou disponibilizado como um link de download. ### Casos de uso comuns * Investigar que aplicação gera falhas de início de sessão para um utilizador específico e porquê, agrupado por código de erro. * Restrinja os resultados com `ApplicationName` (correspondência parcial) ou `Apenas inícios de sessão com falha` quando um utilizador relata problemas de acesso. * Exporte os dados de início de sessão para CSV ou Excel para análise posterior quando a contagem de eventos for demasiado grande para ser lida no portal. ### Comportamento * Os dados do registo de início de sessão são obtidos a partir do endpoint beta do Microsoft Graph, porque a filtragem do tipo de evento de início de sessão e a obtenção de inícios de sessão não interativos requerem propriedades apenas da versão beta (`signInEventTypes`, `authenticationRequirement`). * Os resultados são gravados no **Dados de saída** separador da tarefa em cada execução: um resumo, o resumo por aplicação, os inícios de sessão com falha e, exceto se forem solicitados apenas inícios de sessão com falha, todos os inícios de sessão. A consola mostra as contagens. * Os inícios de sessão não interativos superam largamente os interativos; as tabelas de início de sessão no separador Output Data estão limitadas às 250 entradas mais recentes, mas os ficheiros de relatório exportados contêm sempre o conjunto completo de resultados. ### Licença e permissões necessárias Ler registos de início de sessão através da API do Microsoft Graph requer uma **licença Entra ID P1 ou P2** no Tenant. Os Tenants sem isso recebem um erro 403 da consulta ao registo de início de sessão, mesmo quando todas as permissões do Microsoft Graph são concedidas. Com P1/P2, os registos de início de sessão são retidos por até 30 dias; a retenção de 7 dias da camada gratuita aplica-se ao portal Entra, não a este runbook. Se a consulta ao registo de início de sessão devolver um 403 embora `AuditLog.Read.All` a permissão esteja concedida e o Tenant esteja licenciado, alguns Tenants também exigem `Directory.Read.All` na API de relatórios do Entra. Concedê-la é a solução conhecida; não é declarada por predefinição porque concede acesso de leitura a todos os objetos do diretório. ### Entrega do relatório Os ficheiros do relatório só são gerados quando um método de entrega é selecionado através da **Entrega do relatório** opção (email e/ou ligação de transferência). Com *Apenas dados de saída* selecionado, não são criados ficheiros de relatório e a análise de início de sessão é lida no separador Output Data da tarefa no portal RealmJoin. A entrega por e-mail e a geração do link de download são independentes e podem ser combinadas. Para a ligação de transferência, os ficheiros do relatório são carregados para a Storage Account do Azure configurada nas `RJReport.StorageAccount.*` definições de Tenant, e são devolvidos links de download SAS com prazo limitado. O carregamento para o armazenamento autentica-se com a identidade gerida da conta de Automação; essa identidade precisa da **Leitor e acesso aos dados** função RBAC na Storage Account de destino (isto é uma atribuição de Azure RBAC, não uma permissão de aplicação do Graph). ### Configuração relativa ao envio de emails O envio de um relatório por email é opcional e só acontece quando *Enviar também o relatório por email* ou *Enviar também email e ligação de transferência* é selecionado como entrega do relatório; nesse caso é necessário um destinatário. O endereço do remetente é obtido de `RJReport.EmailSender` Tenant. Este runbook envia emails utilizando a API do Microsoft Graph. Para enviar emails através da Graph API, é necessário configurar um endereço de email existente na personalização do runbook. Consulte a [documentação das definições de relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obter detalhes sobre todas as definições disponíveis. #### Branding do email O email do relatório respeita as definições opcionais de `RJReport.Branding.*` do Tenant: * **Imagem do cabeçalho e do rodapé** – URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada * **Ligação no rodapé** – destino da imagem do rodapé * **Cor de destaque e do texto** – valores hexadecimais de 6 dígitos, por exemplo `#0052cc` Quando estas definições não estão configuradas, são utilizadas as imagens e cores predefinidas do RealmJoin. Uma imagem que não possa ser transferida ou validada, ou um valor de cor inválido, nunca impede o email do relatório – é utilizada em vez disso a predefinição correspondente. Instruções de configuração e requisitos da imagem: [Branding do email](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional). ### Interpretar os resultados O Entra conta algumas interrupções de início de sessão como erros (por exemplo 50140 "Keep me signed in", 50058 e 50076), pelo que aparecem como falhas e são incluídas na taxa de falhas por aplicação. Verifique o motivo da falha antes de tratar uma taxa de falhas elevada como um problema genuíno. Os códigos de erro são códigos de erro de início de sessão do Entra ID; procure-os em . Os dados do registo de início de sessão normalmente apresentam um atraso de \~15 minutos, mas podem demorar até 2 horas para alguns registos - um início de sessão muito recente pode ainda não aparecer. Todos os carimbos de data/hora são apresentados em UTC. ### Localização Utilizador → Segurança → Listar eventos de início de sessão **Nome completo do Runbook** rjgit-user\_security\_list-signin-events ### Detalhes | Propriedade | Valor | | ------------------- | ------------------------------------------------------------------------------------------------------------------ | | Versão | 1.1.0 | | Módulos necessários |

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

| | Agendável | não | ### Permissões #### Permissões da aplicação * **Tipo**: Microsoft Graph * AuditLog.Read.All * *Lê os eventos de início de sessão em Entra ID do utilizador de destino a partir de auditLogs/signIns (beta) para criar o relatório* * User.Read.All * *Resolve o utilizador de destino para obter id, userPrincipalName e displayName* * Mail.Send *(opcional — funcionalidade: Relatório por email)* * *Envia o e-mail do relatório de início de sessão com anexos CSV/XLSX através de Send-RjRbReportEmail quando a entrega por e-mail é selecionada* * Organization.Read.All *(opcional — funcionalidade: Relatório por email)* * *Lê /organization para colocar o nome do Tenant no rodapé do e-mail do relatório* #### Notas de permissão Azure Storage Account: função 'Leitor e acesso aos dados' para a identidade gerida da conta de Automação na Storage Account de destino - o carregamento obtém as chaves da conta através de listKeys (necessário apenas para as opções de ligação de transferência) ### Parâmetros #### Nome de utilizador Nome principal do utilizador sobre o qual o runbook atua. Definido pelo portal a partir do utilizador selecionado. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | verdadeiro | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### Dias Quantos dias de registos de início de sessão incluir, 1 a 30. | Propriedade | Valor | | -------------------------- | -------------------- | | Obrigatório | falso | | Valor predefinido | 7 | | Tipo | Int32 | | Nome de exibição do portal | Dias para retroceder | #### Tipo de início de sessão Inícios de sessão interativos pelo utilizador, não interativos por aplicações e tokens, ou ambos. | Propriedade | Valor | | -------------------------- | ------------------------ | | Obrigatório | falso | | Valor predefinido | Apenas interativos | | Tipo | Cadeia de caracteres | | Nome de exibição do portal | Tipo de início de sessão | #### Apenas inícios de sessão com falha Oculta os inícios de sessão com êxito para que as falhas e os respetivos motivos se destaquem. | Propriedade | Valor | | -------------------------- | ----------------------------------- | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Nome de exibição do portal | Apenas inícios de sessão com falha? | #### ApplicationName Mostra apenas inícios de sessão de aplicações cujo nome contém este texto. Deixe em branco para todas as aplicações. | Propriedade | Valor | | -------------------------- | -------------------- | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Nome de exibição do portal | Filtro de aplicação | #### EmailFrom Endereço do remetente do email do relatório. Obtido da definição do Tenant RJReport.EmailSender. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingHeaderImageUrl Imagem de cabeçalho do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.HeaderImageUrl; é utilizado o cabeçalho predefinido do RealmJoin quando estiver vazio. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingFooterImageUrl Imagem de rodapé do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.FooterImageUrl; é utilizado o rodapé predefinido do RealmJoin quando estiver vazio. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingFooterLink Ligação por trás da imagem de rodapé do email do relatório. Obtida da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é utilizado quando estiver vazio. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingAccentColor Cor de destaque do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.AccentColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingTextColor Cor do texto do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.TextColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### SendEmailReport Se o relatório é enviado por e-mail. Predefinido na personalização do runbook. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### EmailTo Enviar o relatório para estes endereços. Separe vários com vírgulas; cada destinatário recebe um email separado. | Propriedade | Valor | | -------------------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Nome de exibição do portal | Endereço(s) de email do(s) destinatário(s) | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ReportFileFormat Entregar o relatório como CSV, como uma pasta de trabalho do Excel ou ambos. | Propriedade | Valor | | -------------------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | CSV e XLSX | | Tipo | Cadeia de caracteres | | Nome de exibição do portal | Formato do ficheiro do relatório | | Oculto no portal | sim (predefinido através da personalização do runbook) | **Opções do portal** | Opção do portal | Valor | | --------------- | ----------- | | CSV e XLSX | CSV e XLSX | | Apenas CSV | Apenas CSV | | Apenas XLSX | Apenas XLSX | #### CreateDownloadLink Também carregue o relatório e devolva uma ligação de download que expira após alguns dias. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ContainerName Contentor de armazenamento para o qual os ficheiros do relatório são carregados. Definir por runbook. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | user-signin-events | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ResourceGroupName Grupo de recursos da conta de armazenamento para carregamentos do relatório. Obtido a partir da definição de tenant RJReport.StorageAccount.ResourceGroup. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### StorageAccountName Conta de armazenamento para carregamentos do relatório. Obtida a partir da definição de tenant RJReport.StorageAccount.StorageAccountName. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### LinkExpiryDays Número de dias que uma ligação de download permanece válida. Obtido a partir da definição de tenant RJReport.StorageAccount.LinkExpiryDays. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | 6 | | Tipo | Int32 | | Oculto no portal | sim (predefinido através da personalização do runbook) | [Voltar à visão geral da referência do Runbook](/pt/automatizacao/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/pt/automatizacao/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.