> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-references/org/applications/report-expiring-application-credentials_scheduled.md).
# Rapport planifié des informations d'identification d'application expirant
Rapporter les secrets clients et certificats expirant des enregistrements d'application
{% hint style="info" %}
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 seul objet. Voir [Planification](/fr/automatisation/runbooks/scheduling.md) pour plus de détails sur la configuration des planifications de runbook.
{% endhint %}
### Description
Répertorie les secrets clients et les certificats des enregistrements 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 via un 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 d’échéance 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 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 (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 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 *Uniquement les données de sortie* 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 avec 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 d’un 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 Storage Account s’authentifie avec l’identité managée du compte Automation ; cette identité nécessite le **Reader and Data Access** rôle RBAC sur le Storage Account cible (il s’agit d’une attribution Azure RBAC, pas 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èce jointe.
Les planifications créées avant l’ **Livraison du rapport** existence de l’option continuent d’envoyer leur e-mail : un destinataire enregistré suffit encore à activer l’e-mail pour eux. Lorsqu’une telle planification est ouverte en modification, l’option affiche *Uniquement les données de sortie*; sélectionnez à 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 **Livraison du rapport**; un destinataire est alors requis. L’adresse de l’expéditeur est reprise depuis le `RJReport.EmailSender` paramètre 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](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) pour plus de détails sur tous les paramètres disponibles.
#### Branding des e-mails
L’e-mail du rapport prend en compte l’optionnel `RJReport.Branding.*` paramètres Tenant :
* **Image d’en-tête et de pied de page** - URL HTTPS publiques, PNG/JPEG/GIF, max. 200 Ko chacune
* **Lien de pied de page** - cible de l’image de pied de page
* **Couleur d’accent et de texte** - valeurs hexadécimales à 6 chiffres, par ex. `#0052cc`
Lorsque ces paramètres ne sont pas configurés, les graphismes 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 invalide, n’empêche jamais l’e-mail du rapport - le défaut correspondant est utilisé à la place.
Instructions de configuration et exigences relatives aux images : [Branding des e-mails](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).
### Emplacement
Organisation → Applications → Rapport sur les identifiants d’application arrivant à expiration (planifié)
**Nom complet du runbook**
rjgit-org\_applications\_report-expiring-application-credentials\_scheduled
### Détails
| Propriété | Valeur |
| -------------- | ------------------------------------------------------------------------------------------------------------------ |
| Version | 1.5.0 |
| Modules requis | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
Az.Accounts (>= 5.5.2)
|
| Planifiable | oui |
### Autorisations
#### Autorisations d’application
* **Type**: Microsoft Graph
* Application.Read.All
* *Lit tous les enregistrements d’application pour évaluer les dates d’expiration des certificats et des secrets clients*
* 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 'Reader and Data Access' 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 (requis uniquement pour les options de lien de téléchargement)
### Paramètres
#### listOnlyExpiring
Uniquement les identifiants expirant dans « Jours avant expiration », ou tous les identifiants, y compris ceux déjà expirés.
| Propriété | Valeur |
| -------------------------- | -------------------- |
| Obligatoire | faux |
| Valeur par défaut | Vrai |
| Type | Booléen |
| Nom d’affichage du portail | Quels identifiants ? |
**Options du portail**
| Option du portail | Valeur |
| -------------------------------------------------------------- | ------ |
| Répertorier uniquement les identifiants sur le point d’expirer | vrai |
| Répertorier tous les identifiants | faux |
#### Jours
Les identifiants expirant 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.
| Propriété | Valeur |
| -------------------------- | ---------------------- |
| Obligatoire | faux |
| Valeur par défaut | 30 |
| Type | Int32 |
| Nom d’affichage du portail | Jours avant expiration |
#### CredentialType
Secrets clients, certificats ou les deux.
| Propriété | Valeur |
| -------------------------- | ------------------ |
| Obligatoire | faux |
| Valeur par défaut | Les deux |
| Type | Chaîne |
| Nom d’affichage du portail | Type d’identifiant |
**Options du portail**
| Option du portail | Valeur |
| ------------------------------ | ------------- |
| 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.
| Propriété | Valeur |
| -------------------------- | -------------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne |
| Nom d’affichage du portail | Identifiants d’application |
#### ReportFileFormat
Distribuez le rapport en CSV, en classeur Excel ou dans les deux formats.
| 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 |
#### Créer un lien de téléchargement
Télécharge également 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 |
| 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 vers lequel les fichiers du rapport sont téléversés. À définir par runbook.
| Propriété | Valeur |
| ---------------------- | -------------------------------------------------- |
| 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 compte de stockage pour les téléversements du rapport. Pris à partir du paramètre du 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
Compte de stockage pour les téléversements du rapport. Pris à partir du paramètre du 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 du 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) |
#### SendEmailReport
Envoyer le rapport à l’adresse e-mail du destinataire.
| Propriété | Valeur |
| -------------------------- | -------------------------------------------------- |
| 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 distinct.
| 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 de l’expéditeur de l’e-mail du rapport. Prise dans le paramètre 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.). Prise dans le paramètre 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.). Prise dans le paramètre 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) |
#### BrandingFooterLink
Lien derrière l’image de pied de page de l’e-mail du rapport. Pris dans le paramètre 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’accent de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Prise dans le paramètre Tenant RJReport.Branding.AccentColor ; la valeur par défaut RealmJoin est utilisée si vide ou non valide.
| 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. Prise dans le paramètre Tenant RJReport.Branding.TextColor ; la valeur par défaut RealmJoin est utilisée si vide ou non valide.
| 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) |
[Retour à l’aperçu de la référence du runbook](/fr/automatisation/runbooks/runbook-references.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-references/org/applications/report-expiring-application-credentials_scheduled.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.