Configuración de informes de runbooks
Configure ajustes centralizados de entrega por correo electrónico y almacenamiento para runbooks de informes.
Descripción general
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 remitente configurada
cargados en un Storage Account de Azure — y puestos a disposición mediante un enlace de descarga SAS con tiempo limitado
Compatibilizar ambos canales de entrega es el estándar previsto para todos los runbooks de informes de ahora en adelante. Es posible que todavía no todos los runbooks de informes admitan ambos canales, pero el conjunto de runbooks compatibles crece continuamente. Ambos canales pueden habilitarse de forma independiente o en combinación.
Todas las configuraciones compartidas se configuran una sola vez en RealmJoin Runbook Customization y se aplican automáticamente a todos los runbooks que usan la característica correspondiente. Las configuraciones que difieren por runbook (como el nombre del contenedor de destino) no forman parte de esta configuración central y se establecen directamente en el runbook respectivo.
Las funciones que consumen estas configuraciones — Send-RjRbReportEmail y Publish-RjRbFilesToStorageContainer — son proporcionadas por el módulo RealmJoin.RunbookHelper de PowerShell. Consulte Funciones de informe 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 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.
Configuración
Como se describe en detalle en la documentación de Personalización basada en JSON navegue a RealmJoin Runbook Customization en el Portal de RealmJoin (Settings > Runbook Customizations).
En el bloque Settings agregue o modifique la sección RJReport para incluir la propiedad EmailSender con la dirección de correo electrónico remitente deseada:
{
"Settings": {
"RJReport": {
"EmailSender": "realmjoin-report@contoso.com"
}
}
}Reemplace realmjoin-report@contoso.com con 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. Si la información de contacto se incluye realmente en un correo de notificación lo determina el propio runbook correspondiente; solo los runbooks que implementan los parámetros de Service Desk correspondientes (por ejemplo, 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 sección RJReport :
Parámetros:
ServiceDesk_DisplayName— Nombre visible de su Service Desk (por ejemplo, "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 clicable)
Todos los parámetros son opcionales. Si se configuran, aparecerán en el pie de página del correo electrónico como enlaces clicables.
Nota: Algunos runbooks además aceptan un enlace por ejecución a un ticket (por ejemplo,
ServiceDeskTicketUrl) para hacer referencia al ticket específico que desencadenó la solicitud. Este es un parámetro del runbook, no parte de esta configuración central.
Entrega de 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 puede utilizarse 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 cuenta de automatización (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 RealmJoin Runbook Customization y agregue una sub-sección StorageAccount al bloque RJReport :
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 caduca el enlace de descarga SAS generado
AddBlobNamePrefix
no
true
Antepone una marca de tiempo (yyyyMMdd-HHmmss) al nombre del blob para evitar sobrescrituras
UseRandomPrefix
no
false
Usa una cadena aleatoria alfanumérica de 6 caracteres como prefijo en lugar de una marca de tiempo; solo se aplica cuando AddBlobNamePrefix es true
Nota: Las configuraciones específicas de un runbook individual, como el nombre del contenedor de destino o un nombre de blob personalizado, se configuran directamente en ese runbook y, a propósito, no forman parte de esta configuración central.
Ejemplo combinado
El siguiente fragmento muestra una configuración RJReport completa con todas las características habilitadas:
Última actualización
¿Te fue útil?