Rapport planifié des informations d'identification d'application expirant
Rapporter les secrets clients et certificats expirant des enregistrements d'application
Description
Répertorie les secrets clients et les certificats des inscriptions d’application avec leurs dates d’expiration. La liste peut être limitée aux identifiants qui expirent dans un nombre de jours choisi et à certaines applications. Les résultats apparaissent également sous forme de tableaux dans l’onglet Output Data de l’exécution. Rien n’est modifié. Le rapport peut être envoyé par e-mail ou fourni sous forme de lien de téléchargement.
Statut des identifiants
Chaque identifiant reçoit un statut en fonction du nombre de jours restants avant son expiration :
Expiré - la date de fin est dépassée (affiché uniquement lorsque tous les identifiants sont répertoriés)
Critical - expire dans les 7 jours
Warning - expire dans Jours avant l’expiration lorsque seuls les identifiants arrivant à expiration sont répertoriés, dans les 30 jours lorsque tous les identifiants sont répertoriés
Valide - expire plus tard que cela (affiché uniquement lorsque tous les identifiants sont répertoriés)
Avec Répertorier uniquement les identifiants sur le point d’expirer, les identifiants déjà expirés sont exclus. Jours avant l’expiration n’est pas utilisé lorsque tous les identifiants sont répertoriés.
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 sélectionné, les résultats sont lus directement dans l’onglet Output Data du portail RealmJoin : un tableau récapitulatif plus un tableau par statut (Identifiants expirés, Identifiants critiques, Identifiants en avertissement, Identifiants valides), chacun pouvant également être exporté vers Excel. Les fichiers du rapport contiennent toutes les colonnes. L’envoi par e-mail et la génération du 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).
Lorsqu’aucun identifiant ne correspond aux filtres, aucun fichier n’est créé. Si l’envoi par e-mail est sélectionné, l’e-mail est tout de même envoyé, sans pièces jointes.
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ée comme Livraison du rapport; un destinataire est alors requis. L’adresse de l’expéditeur est reprise depuis l’ 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 → Applications → Rapport d’expiration des identifiants d’application (planifié)
Nom complet du runbook
rjgit-org_applications_report-expiring-application-credentials_scheduled
Détails
Version
1.5.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
Application.Read.All
Lit toutes les inscriptions d’application afin d’évaluer les dates d’expiration des certificats et des secrets
Mail.Send (facultatif — fonctionnalité : rapport par e-mail)
Envoie l’e-mail du rapport via Send-RjRbReportEmail lorsque la livraison par e-mail est sélectionnée
Organization.Read.All (facultatif — fonctionnalité : rapport par e-mail)
Lit le nom d’affichage du Tenant pour l’objet et le corps de l’e-mail
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
listOnlyExpiring
Uniquement les identifiants qui expirent dans « Jours avant l’expiration », ou tous les identifiants, y compris les expirés.
Obligatoire
faux
Valeur par défaut
Vrai
Type
Booléen
Nom d’affichage du portail
Quels identifiants ?
Options du portail
Répertorier uniquement les identifiants sur le point d’expirer
vrai
Répertorier tous les identifiants
faux
Jours
Les identifiants qui expirent dans ce nombre de jours sont considérés comme sur le point d’expirer. Non utilisé lorsque tous les identifiants sont répertoriés.
Obligatoire
faux
Valeur par défaut
30
Type
Int32
Nom d’affichage du portail
Jours avant l’expiration
CredentialType
Secrets clients, certificats ou les deux.
Obligatoire
faux
Valeur par défaut
Les deux
Type
Chaîne
Nom d’affichage du portail
Type d’identifiant
Options du portail
Secrets clients et certificats
Les deux
Secrets clients uniquement
ClientSecrets
Certificats uniquement
Certificates
ApplicationIds
Limite le rapport à ces identifiants d’application (client), séparés par des virgules. Laisser vide pour toutes les applications.
Obligatoire
faux
Valeur par défaut
Type
Chaîne
Nom d’affichage du portail
Identifiants d’application
ReportFileFormat
Remettez le rapport au format CSV, sous forme de classeur Excel, ou les deux.
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
CSV et XLSX
CSV et XLSX
CSV uniquement
CSV uniquement
XLSX uniquement
XLSX uniquement
CreateDownloadLink
Télécharge aussi le rapport et renvoie un lien de téléchargement qui expire après quelques jours.
Obligatoire
faux
Valeur par défaut
Faux
Type
Booléen
Nom d’affichage du portail
Créer un lien de téléchargement ?
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.
Obligatoire
faux
Valeur par défaut
report-expiring-app-credentials
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.
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.
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.
Obligatoire
faux
Valeur par défaut
6
Type
Int32
Masqué dans le portail
oui (prédéfini via la personnalisation du runbook)
SendEmailReport
Envoie le rapport à l’adresse e-mail du destinataire.
Obligatoire
faux
Valeur par défaut
Faux
Type
Booléen
Nom d’affichage du portail
Envoyer le rapport par e-mail ?
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é.
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.
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.
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.
Obligatoire
faux
Valeur par défaut
Type
Chaîne
Masqué dans le portail
oui (prédéfini via la personnalisation du runbook)
BrandingFooterLink
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.
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.
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.
Obligatoire
faux
Valeur par défaut
Type
Chaîne
Masqué dans le portail
oui (prédéfini via la personnalisation du runbook)
Mis à jour
Ce contenu vous a-t-il été utile ?