Configuración del informe de runbook
Configurar de forma centralizada los ajustes de entrega de correo y almacenamiento para runbooks de informes.
Resumen
Varios runbooks de RealmJoin incluyen capacidades automatizadas de generación de informes para entregar informes, notificaciones y alertas directamente a los administradores. Según la configuración, los informes pueden ser:
enviados por correo electrónico — usando la API de Microsoft Graph en nombre de una dirección de remitente configurada
cargados en un Azure Storage Account — y ponerse a disposición como un enlace de descarga SAS con tiempo limitado
Compatibilizar ambos canales de entrega es el estándar previsto para todos los runbooks de informes a partir de ahora. Aún no todos los runbooks de informes pueden admitir ambos canales, pero el conjunto de runbooks compatibles sigue creciendo continuamente. Ambos canales pueden habilitarse de forma independiente o en combinación.
Todos los ajustes compartidos se configuran una sola vez en la Personalización de runbooks de RealmJoin y se aplican automáticamente a todos los runbooks que usan la función correspondiente. Los ajustes que difieren según el runbook (como el nombre del contenedor de destino) no forman parte de esta configuración central y se establecen directamente en el runbook correspondiente.
Las funciones que consumen estos ajustes — Send-RjRbReportEmail y Publish-RjRbFilesToStorageContainer — se proporcionan mediante el RealmJoin.RunbookHelper módulo PowerShell. Consulte Funciones de informes para obtener documentación detallada de uso.
Entrega por correo electrónico
Requisitos previos
Recomendamos usar un buzón compartido dedicado, como realmjoin-report@contoso.com. Este buzón se usará como dirección del remitente para todos los informes. Puede usar una dirección sin respuesta, ya que no se espera que los destinatarios respondan a los informes automatizados.
Nota: La dirección del remitente debe ser de un usuario o de un buzón compartido — un grupo de Microsoft 365 no puede enviar correo mediante la API de Graph. Las direcciones de grupo como destinatarios de informes funcionan técnicamente, pero no se recomiendan: que los miembros reciban realmente el correo depende de la configuración de seguimiento/suscripción del grupo, y los fallos de entrega solo son visibles como informes de no entrega en el buzón del remitente. recipientes funcionan técnicamente, pero no se recomiendan: que los miembros reciban realmente el correo depende de la configuración de seguimiento/suscripción del grupo, y los fallos de entrega solo son visibles como informes de no entrega en el buzón del remitente.
Configuración
Como se describe en detalle en la Personalización basada en JSON documentación, vaya a Personalización de runbooks de RealmJoin en el Portal de RealmJoin (Settings > Runbook Customizations).
En el Settings bloque, agregue o modifique la RJReport sección para incluir la EmailSender propiedad con la dirección de correo electrónico del remitente que desee:
Reemplace realmjoin-report@contoso.com por la dirección real de su buzón compartido.
Información de contacto del Service Desk (opcional)
Esta configuración central solo proporciona los valores unificados de Service Desk para todos los runbooks. Que la información de contacto se incluya realmente en un correo de notificación lo determina el propio runbook correspondiente — solo los runbooks que implementan los parámetros correspondientes de Service Desk (p. ej. ServiceDeskDisplayName, ServiceDeskPortalUrl) leen estos valores y los muestran en sus correos electrónicos.
Para proporcionar la información de contacto del Service Desk para estos runbooks, agregue las siguientes propiedades a la RJReport sección:
Parámetros:
ServiceDesk_DisplayName— Nombre visible de su Service Desk (p. ej., "IT Support", "Help Desk")ServiceDesk_EMail— Dirección de correo electrónico del Service Desk (se muestra como unmailto:enlace)ServiceDesk_Phone— Número de teléfono del Service Desk en formato internacional (se muestra como untel:enlace)ServiceDesk_PortalUrl— URL del portal o sitio web de su Service Desk (se muestra como un enlace)
Todos los parámetros son opcionales. Si se configuran, aparecerán en el pie de página del correo electrónico como enlaces en los que se puede hacer clic.
Nota: Algunos runbooks además aceptan un enlace de ticket por ejecución (p. ej.
ServiceDeskTicketUrl) para hacer referencia al ticket específico que activó la solicitud. Este es un parámetro del runbook, no forma parte de esta configuración central.
Marca de correo electrónico (opcional)
Los correos electrónicos de informe pueden llevar una imagen de marca específica del tenant: los gráficos predeterminados del encabezado y el pie de página de RealmJoin pueden reemplazarse por sus propias imágenes, la imagen del pie de página puede enlazar a un destino personalizado — por ejemplo, su intranet o portal de TI — y los colores de la plantilla pueden ajustarse a su diseño corporativo.
Para configurar la marca, agregue una subsección Branding al bloque RJReport (anidada como StorageAccount):
Parámetros:
HeaderImageUrl
no
gráfico del encabezado de RealmJoin
URL pública HTTPS de una imagen de encabezado personalizada que reemplaza el gráfico de encabezado predeterminado de RealmJoin
FooterImageUrl
no
gráfico del pie de página de RealmJoin
URL pública HTTPS de una imagen de pie de página personalizada que reemplaza el gráfico de pie de página predeterminado de RealmJoin
FooterLink
no
https://www.realmjoin.com
URL a la que enlaza la imagen del pie de página
AccentColor
no
#f8842c (naranja de RealmJoin)
Color de acento de la plantilla de correo electrónico: filas de encabezado de tabla, botones de acción y bordes de acento de los cuadros de información
TextColor
no
#011e33 (azul marino de RealmJoin)
Color de texto principal de la plantilla de correo electrónico: texto del cuerpo, encabezados, elementos de lista, código
Requisitos de imagen:
La imagen debe ser accesible mediante una URL pública HTTPS — por ejemplo, un contenedor de Azure Blob Storage con acceso de lectura anónimo, una CDN o el sitio web de la empresa. También funciona una URL que contenga un token SAS y mantiene el contenedor privado.
Formatos admitidos: PNG, JPEG o GIF. El formato se detecta a partir de la firma del archivo, no de la extensión del archivo.
Las imágenes se renderizan a 750 px de ancho. Las dimensiones recomendadas son 750×200 px (que coinciden con los banners predeterminados) o 1500×400 px para pantallas de alta densidad de píxeles.
Máximo 200 KB por imagen; 100 KB o menos se recomienda. Las imágenes de marca comparten el límite total de tamaño del correo electrónico de ~4 MB con los adjuntos del informe (en comparación, los gráficos predeterminados de RealmJoin son 52 KB y 15 KB).
Requisitos de color:
Los valores deben ser colores hexadecimales de 6 dígitos, incluido el prefijo
#— por ejemplo#0052cc. No se admiten las formas abreviadas (#05c) ni los nombres de colores (rojo).Tanto los correos electrónicos como sus adjuntos se leen en modo claro y oscuro: y elija un color de texto que siga siendo legible sobre una tarjeta de contenido blanca y un color de acento con suficiente contraste frente al texto blanco de los botones.
Los colores de estado (verde/rojo/ámbar para los estados de éxito, error y advertencia) y los grises neutros no se pueden configurar deliberadamente — transmiten un significado que no debe cambiar por tenant.
Las imágenes se descargan y validan mediante el runbook en cada ejecución. Si un ajuste se deja vacío, se usan el gráfico, el color y el enlace del pie de página predeterminados de RealmJoin. Si falla una descarga, una imagen no es válida o un color no es un valor hexadecimal válido, se registra una advertencia y se usa el valor predeterminado correspondiente en su lugar — una configuración de marca defectuosa nunca impide que se envíe un correo electrónico de informe.
Todos los ajustes son opcionales y surten efecto para todos los runbooks que envían correos electrónicos de informe.
Nota: Los ajustes de color requieren RealmJoin.RunbookHelper 0.8.9 o posterior en la Automation Account. Con versiones anteriores del módulo, los ajustes de imagen siguen aplicándose y los colores se ignoran.
Entrega mediante Storage Account
Los runbooks de informes que admiten este canal de entrega pueden cargar su salida en un contenedor de Azure Blob Storage. Tras una carga correcta, el runbook devuelve un enlace SAS con tiempo limitado que se puede usar para descargar el archivo directamente. Este canal puede utilizarse de forma independiente o además de la entrega por correo electrónico.
Requisitos previos
Se requiere un Azure Storage Account existente. La identidad administrada de la Automation Account (o el Service Principal usado por los runbooks) necesita al menos Storage Blob Data Contributor permisos en el Storage Account o en su grupo de recursos.
Configuración
Vaya a Personalización de runbooks de RealmJoin y agregue un StorageAccount al bloque RJReport bloque:
Parámetros:
ResourceGroup
sí
—
Grupo de recursos que contiene el Storage Account
StorageAccountName
sí
—
Nombre del Azure Storage Account
LinkExpiryDays
no
6
Número de días hasta que caduque el enlace de descarga SAS generado
Nota: Los ajustes específicos de un runbook individual — como el nombre del contenedor de destino o un nombre de blob personalizado — se configuran directamente en ese runbook y, de forma intencionada, no forman parte de esta configuración central. Lo mismo se aplica al prefijo del nombre de blob: si un prefijo de marca de tiempo (
yyyyMMdd-HHmmss) se antepone al nombre del blob para evitar sobrescrituras lo controla elAddBlobNamePrefixparámetro dePublish-RjRbFilesToStorageContainer(valor predeterminado$false), que cada runbook pasa explícitamente.
Ejemplo combinado
El siguiente fragmento muestra una RJReport configuración completa con todas las funciones habilitadas:
Última actualización
¿Te fue útil?