For the complete documentation index, see llms.txt. This page is also available as Markdown.

Rapport planifié des demandes d'élévation EPM

Rapporter les demandes d'élévation EPM par statut et ancienneté

Il s'agit d'un runbook planifié. Il est conçu pour s'exécuter selon une planification récurrente plutôt que d'être déclenché pour un objet unique. Voir Planification pour plus de détails sur la configuration des planifications du runbook.

Description

Collecte les demandes d’élévation Endpoint Privilege Management depuis Intune, filtrées par statut et selon leur ancienneté de création. Les demandes sont listées par statut avec un récapitulatif des décomptes. Intune conserve les détails des demandes pendant 30 jours, donc les demandes plus anciennes ne peuvent pas être incluses dans le rapport. Le rapport peut être envoyé par e-mail ou fourni via un lien de téléchargement.

Objectif et cas d’usage

  • Rapports réguliers des activités Endpoint Privilege Management (EPM)

  • Piste d’audit des demandes d’élévation approuvées et refusées

  • Analyse des demandes expirées pour identifier les goulots d’étranglement du processus

  • Identification des applications fréquemment demandées pour des règles d’élévation automatique

Une planification mensuelle est recommandée.

Types de statut

  • En attente : attend la décision d’un administrateur (utilisez Surveiller les demandes EPM en attente pour les alertes urgentes)

  • Approuvée : un administrateur a approuvé la demande, l’utilisateur peut procéder à l’élévation

  • Refusée : un administrateur a rejeté la demande pour des raisons de sécurité ou de stratégie

  • Expirée : la demande a expiré avant qu’un administrateur ne l’examine, ce qui peut indiquer des temps de réponse lents

  • Révoquée : une élévation précédemment approuvée a ensuite été révoquée par un administrateur

  • Terminée : l’utilisateur a exécuté avec succès l’application élevée après approbation

Conservation des données et plages temporelles

  • Intune conserve les détails des demandes EPM pendant 30 jours après leur création.

  • Pour une analyse à long terme, archivez les exports CSV en dehors d’Intune.

  • Le filtre par défaut couvre les états approuvés, refusés, expirés et révoqués au cours des 30 derniers jours.

Fichiers de sortie et du rapport

  • L’onglet Output Data de l’exécution affiche un Résumé tableau avec les décomptes et un tableau par statut sélectionné (par exemple Demandes approuvées), la plus ancienne demande en premier.

  • Les fichiers du rapport contiennent chaque demande correspondante avec tous les détails : horodatages, utilisateurs, appareils, applications, justifications et empreintes de fichier. Ils sont générés au format CSV et/ou Excel (xlsx), selon le format de fichier du rapport sélectionné.

  • Les e-mails sont envoyés individuellement à chaque destinataire pour des raisons de confidentialité.

  • Aucun e-mail n’est envoyé et aucun fichier n’est créé lorsqu’aucune demande ne correspond aux critères du filtre. Une telle exécution se termine normalement ; l’onglet Output Data affiche toujours le résumé.

Livraison du rapport

Les fichiers du rapport ne sont générés que lorsqu’une méthode de livraison est sélectionnée via l’ Livraison du rapport option (e-mail et/ou lien de téléchargement). Avec Données de sortie uniquement Une fois sélectionné, les résultats sont lus directement dans l'onglet Données de sortie du portail RealmJoin, où chaque tableau peut également être exporté vers Excel. L'envoi par e-mail et la génération de lien de téléchargement sont indépendants et peuvent être combinés.

Pour le lien de téléchargement, les fichiers du rapport sont téléversés vers le Storage Account Azure configuré dans les RJReport.StorageAccount.* paramètres du Tenant, et des liens de téléchargement SAS à durée limitée sont renvoyés. Le téléversement vers le stockage s’authentifie avec l’identité managée du compte Automation ; cette identité a besoin du Storage Account Contributor rôle RBAC sur le Storage Account cible (il s’agit d’une attribution Azure RBAC, et non d’une autorisation d’application Graph).

Les planifications créées avant l’ Livraison du rapport option existait continuent d’envoyer leur e-mail : un destinataire enregistré suffit toujours à activer l’e-mail pour eux. Lorsqu’une telle planification est ouverte pour modification, l’option affiche Données de sortie uniquement; sélectionnez de nouveau la livraison avant d’enregistrer, sinon la planification cesse d’envoyer le rapport.

Configuration de l’envoi d’e-mails

L’envoi du rapport par e-mail est facultatif et ne se produit que lorsque Envoyer aussi le rapport par e-mail ou Envoyer aussi par e-mail et lien de téléchargement est sélectionné comme mode de livraison du rapport ; un destinataire est alors requis. L’adresse de l’expéditeur est reprise de RJReport.EmailSender paramètre du tenant.

Ce runbook envoie des e-mails à l’aide de l’API Microsoft Graph. Pour envoyer des e-mails via l’API Graph, vous devez configurer une adresse e-mail existante dans la personnalisation du runbook.

Voir la documentation des paramètres de rapport RealmJoin pour plus de détails sur tous les paramètres disponibles.

Identité visuelle des e-mails

L’e-mail du rapport prend en compte le paramètre facultatif RJReport.Branding.* des paramètres du tenant :

  • Image d’en-tête et de pied de page - URL HTTPS publiques, PNG/JPEG/GIF, 200 Ko max. chacune

  • Lien de pied de page - cible de l’image de pied de page

  • Couleur d’accentuation et du texte - valeurs hexadécimales à 6 chiffres, p. ex. #0052cc

Lorsque ces paramètres ne sont pas configurés, les graphiques et couleurs par défaut de RealmJoin sont utilisés. Une image qui ne peut pas être téléchargée ou validée, ou une valeur de couleur non valide, n’empêche jamais l’e-mail du rapport — la valeur par défaut correspondante est utilisée à la place.

Instructions de configuration et exigences relatives aux images : Identité visuelle des e-mails.

Emplacement

Organisation → Sécurité → Rapport des demandes d’élévation EPM (planifié)

Nom complet du runbook

rjgit-org_security_report-EPM-elevation-requests_scheduled

Détails

Propriété
Valeur

Version

1.4.0

Modules requis

RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.5.2)

Planifiable

oui

Autorisations

Autorisations d’application

  • Type: Microsoft Graph

    • DeviceManagementConfiguration.Read.All

      • Interroge les elevationRequests d’Endpoint Privilege Management selon le statut et la date de création pour générer le rapport

    • Mail.Send (facultatif — fonctionnalité : rapport par e-mail)

      • Envoie l’e-mail du rapport avec des pièces jointes CSV/XLSX via Send-RjRbReportEmail lorsque l’envoi par e-mail est sélectionné

    • Organization.Read.All (facultatif — fonctionnalité : rapport par e-mail)

      • Lit le nom d’affichage et l’ID du locataire pour l’objet de l’e-mail, le corps du message et les noms des fichiers du rapport

Notes sur les autorisations

Azure Storage Account : rôle 'Storage Account Contributor' pour l’identité managée du compte Automation sur le Storage Account cible - le téléversement récupère les clés du compte via listKeys (uniquement requis pour les options de lien de téléchargement)

Paramètres

IncludeApproved

Inclut les demandes qu’un administrateur a approuvées.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Vrai

Type

Booléen

Nom d’affichage du portail

Inclure les demandes approuvées ?

IncludeDenied

Inclut les demandes qu’un administrateur a rejetées.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Vrai

Type

Booléen

Nom d’affichage du portail

Inclure les demandes refusées ?

IncludeExpired

Inclut les demandes qui ont expiré avant qu’une décision ne soit prise.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Vrai

Type

Booléen

Nom d’affichage du portail

Inclure les demandes expirées ?

IncludeRevoked

Inclut les demandes dont l’approbation a ensuite été retirée.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Vrai

Type

Booléen

Nom d’affichage du portail

Inclure les demandes révoquées ?

IncludePending

Inclut les demandes qui attendent encore une décision.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Faux

Type

Booléen

Nom d’affichage du portail

Inclure les demandes en attente ?

IncludeCompleted

Inclut les demandes qui ont été approuvées et utilisées.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Faux

Type

Booléen

Nom d’affichage du portail

Inclure les demandes terminées ?

MaxAgeInDays

Seules les demandes créées au cours de ce nombre de jours sont signalées. Intune conserve les détails des demandes pendant 30 jours, donc une valeur plus élevée est ramenée à 30.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

30

Type

Int32

Nom d’affichage du portail

Créé dans les (jours)

SendEmailReport

Envoie le rapport à l’adresse e-mail du destinataire.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Faux

Type

Booléen

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

EmailTo

Envoyez le rapport à ces adresses. Séparez-en plusieurs par des virgules ; chaque destinataire reçoit un e-mail séparé.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Nom d’affichage du portail

Adresse(s) e-mail du destinataire

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

EmailFrom

Adresse d’expédition de l’e-mail du rapport. Récupérée à partir du paramètre du tenant RJReport.EmailSender.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

BrandingHeaderImageUrl

Image d’en-tête de l’e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, 200 Ko max.). Récupérée à partir du paramètre du tenant RJReport.Branding.HeaderImageUrl ; l’en-tête RealmJoin par défaut est utilisé si vide.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

BrandingFooterImageUrl

Image de pied de page de l’e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, 200 Ko max.). Récupérée à partir du paramètre du tenant RJReport.Branding.FooterImageUrl ; le pied de page RealmJoin par défaut est utilisé si vide.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

Lien derrière l’image de pied de page de l’e-mail du rapport. Récupéré à partir du paramètre du tenant RJReport.Branding.FooterLink ; realmjoin.com est utilisé si vide.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

BrandingAccentColor

Couleur d’accentuation de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Récupérée à partir du paramètre du tenant RJReport.Branding.AccentColor ; la valeur par défaut RealmJoin est utilisée si vide ou invalide.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

BrandingTextColor

Couleur du texte de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Récupérée à partir du paramètre du tenant RJReport.Branding.TextColor ; la valeur par défaut RealmJoin est utilisée si vide ou invalide.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

ReportFileFormat

Remettez le rapport au format CSV, sous forme de classeur Excel, ou les deux.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

CSV et XLSX

Type

Chaîne

Nom d’affichage du portail

Format du fichier de rapport

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

Options du portail

Option du portail
Valeur

CSV et XLSX

CSV et XLSX

CSV uniquement

CSV uniquement

XLSX uniquement

XLSX uniquement

Télécharge aussi le rapport et renvoie un lien de téléchargement qui expire après quelques jours.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Faux

Type

Booléen

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

Nom du conteneur

Conteneur de stockage dans lequel les fichiers du rapport sont téléversés. À définir pour chaque runbook.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

report-epm-elevation-requests

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

Nom du groupe de ressources

Groupe de ressources du Storage Account pour les téléversements de rapports. Pris à partir du paramètre Tenant RJReport.StorageAccount.ResourceGroup.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

Nom du Storage Account

Storage Account pour les téléversements de rapports. Pris à partir du paramètre Tenant RJReport.StorageAccount.StorageAccountName.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

LinkExpiryDays

Nombre de jours pendant lesquels un lien de téléchargement reste valide. Pris à partir du paramètre Tenant RJReport.StorageAccount.LinkExpiryDays.

Propriété
Valeur

Obligatoire

faux

Valeur par défaut

6

Type

Int32

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

Mis à jour

Ce contenu vous a-t-il été utile ?