Exportar usuarios de aplicaciones empresariales
Exportar los propietarios y usuarios de todas las aplicaciones empresariales
Descripción
Enumera todas las aplicaciones empresariales, o todos los Service Principals, con sus propietarios y los usuarios y grupos asignados a ellas, para revisiones y auditorías. No se cambia nada. El informe puede enviarse por correo electrónico o proporcionarse como un enlace de descarga.
Cómo se muestran los propietarios y las asignaciones
Cada fila es un propietario (PrincipalRole Owner) o una asignación (PrincipalRole Miembro) de una aplicación. Una aplicación sin propietario obtiene una fila de propietario con un campo vacío PrincipalId.
Los propietarios pueden ser usuarios o Service Principals, diferenciados por
PrincipalType. Un usuario se muestra con su nombre principal de usuario, un Service Principal con su nombre para mostrar y su ID de aplicación entre corchetes.Los usuarios asignados se muestran con su nombre principal de usuario, los grupos asignados con su alias de correo y nombre para mostrar, y los Service Principals asignados con su ID de objeto.
Cuando falla una búsqueda, por ejemplo por falta de permisos,
PrincipalIdmuestra(búsqueda fallida), después del ID de objeto cuando se conoce, y la ejecución escribe una advertencia. Esa fila no significa que la aplicación no tenga propietario ni asignación.
Configuración relativa al envío de correos electrónicos
El envío de un informe por correo electrónico es opcional y solo ocurre cuando se proporciona un destinatario (EmailTo). La dirección del remitente se toma de la configuración de RJReport.EmailSender de Tenant.
Este runbook envía correos electrónicos mediante la API de Microsoft Graph. Para enviar correos mediante Graph API, debes configurar una dirección de correo electrónico existente en la personalización del runbook.
Consulta la documentación de configuración de informes de RealmJoin para conocer todos los ajustes disponibles.
Marca del correo electrónico
El correo electrónico del informe respeta las RJReport.Branding.* configuraciones opcionales de Tenant:
Imagen de cabecera y pie de página – URLs 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.
Ubicación
Organización → Aplicaciones → Exportar usuarios de aplicaciones empresariales
Nombre completo del runbook
rjgit-org_applications_export-enterprise-application-users
Detalles
Versión
1.5.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
Application.Read.All
Enumera Service Principals y lee sus propietarios y asignaciones de roles de aplicación
Directory.Read.All
Resuelve los usuarios y grupos asignados y lee el nombre del Tenant para el informe
Mail.Send (opcional — característica: informe por correo electrónico)
Envía el correo electrónico del informe mediante Send-RjReportEmail cuando EmailTo está configurado
Organization.Read.All (opcional — característica: informe por correo electrónico)
Lee el nombre para mostrar del Tenant para el correo electrónico del informe cuando EmailTo está configurado
Notas sobre permisos
Azure Storage Account: rol 'Reader and Data Access' para la identidad administrada de la Automation Account en el Storage Account de destino - la carga recupera las claves de la cuenta mediante listKeys (solo necesario para el enlace de descarga)
Parámetros
entAppsOnly
Solo aplicaciones empresariales, o todos los Service Principals del Tenant.
Obligatorio
falso
Valor predeterminado
Verdadero
Tipo
Booleano
Nombre para mostrar en el portal
Alcance
Opciones del portal
Listar solo aplicaciones empresariales
true
Listar todos los Service Principals / aplicaciones
falso
ReportFileFormat
Entrega el informe como CSV, como un libro de Excel o ambos.
Obligatorio
falso
Valor predeterminado
CSV y XLSX
Tipo
Cadena
Nombre para mostrar en el portal
Formato del archivo del informe
Opciones del portal
CSV y XLSX
CSV y XLSX
Solo CSV
Solo CSV
Solo XLSX
Solo XLSX
CreateDownloadLink
También sube el informe y devuelve un enlace de descarga que expira después de unos días.
Obligatorio
falso
Valor predeterminado
Verdadero
Tipo
Booleano
Nombre para mostrar en el portal
¿Crear un enlace de descarga?
Opciones del portal
Sí: subir el informe y devolver un enlace de descarga
true
No: no crear un enlace de descarga
falso
ContainerName
Contenedor de almacenamiento al que se cargan los archivos del informe. Tomado de la configuración del Tenant EntAppsReport.Container.
Obligatorio
falso
Valor predeterminado
Tipo
Cadena
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
ResourceGroupName
Grupo de recursos del Storage Account para las cargas del informe. Tomado de la configuración del Tenant EntAppsReport.ResourceGroup; cuando no está configurado, se usa RJReport.StorageAccount.ResourceGroup.
Obligatorio
falso
Valor predeterminado
Tipo
Cadena
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
StorageAccountName
Storage Account para las cargas del informe. Tomado de la configuración del Tenant EntAppsReport.StorageAccount.Name; cuando no está configurado, se usa RJReport.StorageAccount.StorageAccountName.
Obligatorio
falso
Valor predeterminado
Tipo
Cadena
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
SubscriptionId
ID de suscripción de la Storage Account indicada en ResourceGroupName y StorageAccountName. No se toma de una configuración del Tenant; cuando está vacío, se usa la suscripción en la que inicia sesión la identidad administrada.
Obligatorio
falso
Valor predeterminado
Tipo
Cadena
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
LinkExpiryDays
Número de días que un enlace de descarga permanece válido. Tomado de la configuración del Tenant EntAppsReport.LinkExpiryDays; cuando no está configurado, se usa RJReport.StorageAccount.LinkExpiryDays.
Obligatorio
falso
Valor predeterminado
6
Tipo
Int32
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
RJReportResourceGroupName
Grupo de recursos del Storage Account para las cargas del informe. Tomado de la configuración del Tenant RJReport.StorageAccount.ResourceGroup y se usa cuando EntAppsReport.ResourceGroup no está configurado.
Obligatorio
falso
Valor predeterminado
Tipo
Cadena
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
RJReportStorageAccountName
Storage Account para las cargas del informe. Tomado de la configuración del Tenant RJReport.StorageAccount.StorageAccountName y se usa cuando EntAppsReport.StorageAccount.Name no está configurado.
Obligatorio
falso
Valor predeterminado
Tipo
Cadena
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
RJReportSubscriptionId
ID de suscripción de la Storage Account para las cargas del informe. Tomado de la configuración del Tenant RJReport.StorageAccount.SubscriptionId y usado cuando la Storage Account proviene de RJReport.StorageAccount.
Obligatorio
falso
Valor predeterminado
Tipo
Cadena
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
RJReportLinkExpiryDays
Número de días que un enlace de descarga permanece válido. Tomado de la configuración del Tenant RJReport.StorageAccount.LinkExpiryDays y se usa cuando EntAppsReport.LinkExpiryDays no está configurado.
Obligatorio
falso
Valor predeterminado
0
Tipo
Int32
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
EmailFrom
Dirección del remitente del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.EmailSender.
Obligatorio
falso
Valor predeterminado
Tipo
Cadena
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
BrandingHeaderImageUrl
Imagen de cabecera 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 la cabecera predeterminada de RealmJoin cuando está vacía.
Obligatorio
falso
Valor predeterminado
Tipo
Cadena
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
BrandingFooterImageUrl
Imagen del 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ía.
Obligatorio
falso
Valor predeterminado
Tipo
Cadena
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
BrandingFooterLink
Enlace detrás de la imagen del pie de página del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.Branding.FooterLink; se usa realmjoin.com cuando está vacía.
Obligatorio
falso
Valor predeterminado
Tipo
Cadena
Oculto en el portal
sí (preestablecido 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.
Obligatorio
falso
Valor predeterminado
Tipo
Cadena
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
BrandingTextColor
Color del 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.
Obligatorio
falso
Valor predeterminado
Tipo
Cadena
Oculto en el portal
sí (preestablecido mediante la personalización del runbook)
EmailTo
Envía el informe a estas direcciones. Separa varias con comas; cada destinatario recibe un correo electrónico independiente.
Obligatorio
falso
Valor predeterminado
Tipo
Cadena
Nombre para mostrar en el portal
Dirección(es) de correo electrónico del destinatario
Última actualización
¿Te fue útil?