Reportar registo de aplicações

Gerar e enviar por e-mail um relatório abrangente de registo de aplicações

Descrição

Este runbook gera um relatório de todos os registos de aplicações no Microsoft Entra ID e pode, opcionalmente, incluir registos eliminados. Exporta os resultados para ficheiros CSV e uma pasta de trabalho do Excel (xlsx) e pode enviá-los por e-mail. Os ficheiros do relatório também podem ser carregados para uma Azure Storage Account, devolvendo ligações de transferência temporárias. O parâmetro ReportFileFormat controla quais formatos de ficheiro são gerados e entregues (apenas CSV, CSV e XLSX, ou apenas XLSX). Quando os anexos CSV excedem o limite de tamanho do e-mail e "CSV & XLSX" é selecionado, o e-mail recorre apenas à pasta de trabalho do Excel. Utilize-o para fins de inventário periódico, revisão e auditoria.

Configuração relativa ao envio de emails

O envio de um relatório por email é opcional e só acontece quando é fornecido um destinatário (E-mail para) . O endereço do remetente é obtido da RJReport.EmailSender configuração do Tenant.

Este runbook envia emails usando a API Microsoft Graph. Para enviar emails através da API Graph, é 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 para obter detalhes.

Localização

Organização → Aplicações → Relatório de Registo de Aplicações

Nome completo do Runbook

rjgit-org_applications_report-application-registration

Detalhes

Propriedade	Valor
Versão	1.1.0
Módulos necessários	RealmJoin.RunbookHelper (>= 0.8.7) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.3.4)
Agendável	não

Permissões

Permissões da aplicação

• Tipo: Microsoft Graph

  • Application.Read.All
  • Directory.Read.All
  • Mail.Send
  • Organization.Read.All

Parâmetros

E-mail para

Se especificado, será enviado um e-mail com o relatório para o(s) endereço(s) fornecido(s). Pode ser um único endereço ou vários endereços separados por vírgulas (string). A função envia e-mails individuais para cada destinatário por motivos de privacidade.

Propriedade	Valor
Obrigatório	falso
Valor predefinido
Tipo	Cadeia de caracteres
Nome de exibição no portal	Endereço(s) de email do destinatário

E-mail do remetente

O endereço de e-mail do remetente. Isto precisa de ser configurado na personalização do runbook.

Propriedade	Valor
Obrigatório	falso
Valor predefinido
Tipo	Cadeia de caracteres
Oculto no portal	sim (predefinido via personalização do runbook)

IncludeDeletedApps

Se deve incluir registos de aplicações eliminados no relatório (predefinição: true)

Propriedade	Valor
Obrigatório	falso
Valor predefinido	Verdadeiro
Tipo	Booleano
Nome de exibição no portal	Incluir Registos de Aplicações Eliminados

ReportFileFormat

Controla quais formatos de ficheiro de relatório são gerados e entregues: "CSV only", "CSV & XLSX" (predefinição) ou "XLSX only".

Propriedade	Valor
Obrigatório	falso
Valor predefinido	CSV & XLSX
Tipo	Cadeia de caracteres
Nome de exibição no portal	Formato do ficheiro de relatório

Opções do portal

Opção do portal	Valor
CSV & XLSX
CSV only
XLSX only

CreateDownloadLink

Se ativado, os ficheiros de relatório são carregados para um Azure Storage Account e são devolvidas ligações de download com tempo limitado. Desativado por predefinição.

Propriedade	Valor
Obrigatório	falso
Valor predefinido	Falso
Tipo	Booleano
Nome de exibição no portal	Criar uma ligação de download do ficheiro (carregar relatório para o armazenamento)?

Opções do portal

Opção do portal	Valor
Sim - carregar relatório e devolver uma ligação de download	verdadeiro
Não - não criar uma ligação de download	falso

ContainerName

Nome do contentor de armazenamento usado para o carregamento. Configurado por runbook (não é uma configuração global do RJReport).

Propriedade	Valor
Obrigatório	falso
Valor predefinido	report-application-registration
Tipo	Cadeia de caracteres
Oculto no portal	sim (predefinido via personalização do runbook)

ResourceGroupName

Grupo de recursos que contém a conta de armazenamento. Obtido a partir das configurações do Tenant RJReport.

Propriedade	Valor
Obrigatório	falso
Valor predefinido
Tipo	Cadeia de caracteres
Oculto no portal	sim (predefinido via personalização do runbook)

StorageAccountName

Nome da conta de armazenamento usado para o carregamento. Obtido a partir das configurações do Tenant RJReport.

Propriedade	Valor
Obrigatório	falso
Valor predefinido
Tipo	Cadeia de caracteres
Oculto no portal	sim (predefinido via personalização do runbook)

LinkExpiryDays

Número de dias até a ligação de download gerada expirar. Obtido a partir das configurações do Tenant RJReport.

Propriedade	Valor
Obrigatório	falso
Valor predefinido	6
Tipo	Int32
Oculto no portal	sim (predefinido via personalização do runbook)

Voltar à visão geral da referência do Runbook