descrição geral da API dos registos de auditoria do Microsoft Entra
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Microsoft Entra fornece um registo de auditoria de todas as atividades de utilizadores e aplicações no seu inquilino para ajudá-lo a controlar todas as atividades no seu inquilino e também estar em conformidade. Estes registos incluem a atividade de início de sessão da aplicação e do utilizador, bem como alterações ao diretório.
A disponibilidade destes registos de auditoria é regida pelas políticas de retenção de dados Microsoft Entra.
Registos de auditoria disponíveis
Observação
Os registos de auditoria de atributos de segurança personalizados e os registos de aprovisionamento estão atualmente disponíveis apenas no beta ponto final.
Registos de auditoria de diretórios
Os registos de auditoria de diretórios fornecem-lhe acesso ao histórico de todas as tarefas realizadas no seu inquilino, quer por um utilizador, quer por um serviço. Entre outros benefícios, os dados fornecidos permitem que você aborde cenários comuns, como:
- Quem concedeu acesso ao grupo de administradores a um usuário de diretório?
- Quais usuários estão se conectando a um aplicativo adquirido recentemente?
- Quantas redefinições de senhas foram feitas no diretório?
Entradas
Os registos de início de sessão ajudam-no a determinar quem ou o que executou as tarefas comunicadas pelos registos de auditoria de diretórios. Os registos incluem inícios de sessão de utilizador interativos, inícios de sessão de utilizador não interativos, inícios de sessão do principal de serviço e inícios de sessão de identidade gerida.
O relatório de entrada ajuda você a responder a perguntas como:
- O que é o padrão de entrada de um usuário?
- Quantos usuários entraram durante a semana passada?
- Qual é o status dessas entradas?
O que posso fazer com os relatórios de atividades do Microsoft Graph?
Aqui estão solicitações populares para trabalhar com dados de relatório:
| Operation | URL |
|---|---|
| OBTER atividades de usuário do locatário | https://graph.microsoft.com/v1.0/auditLogs/directoryAudits |
| Get custom security attribute audit logs (Registos de auditoria de atributos de segurança personalizados GET) | https://graph.microsoft.com/v1.0/auditLogs/customSecurityAttributeAudits |
| Inícios de sessão de inquilino GET | https://graph.microsoft.com/beta/auditLogs/signIns |
Requisitos de licença
Os relatórios de atividades estão disponíveis para os recursos que você licenciou. Se você possui uma licença para um recurso específico, também tem acesso aos relatórios. Para obter mais informações sobre os requisitos de licença para os diferentes relatórios de atividade, veja Microsoft Entra registos de auditoria: Requisitos de licenças e funções.