Ablaufende Anwendungsanmeldeinformationen melden – geplant
Ablaufdatum aller Anwendungsregistrierungs-Anmeldeinformationen auflisten
Beschreibung
Dieses Runbook listet die Ablaufdaten von Anwendungsregistrierungs-Anmeldeinformationen auf, einschließlich Client Secrets und Zertifikaten. Es kann optional nach Anwendungs-IDs filtern und die Ausgabe auf Anmeldeinformationen beschränken, die kurz vor dem Ablauf stehen.
Optional kann der Bericht per E-Mail mit CSV- und/oder Excel-(xlsx)-Anlagen gesendet werden. Die Berichtsdateien können auch in ein Azure Storage Account hochgeladen werden, wobei zeitlich begrenzte Download-Links zurückgegeben werden. Der Parameter ReportFileFormat steuert, welche Dateiformate generiert und bereitgestellt werden (nur CSV, CSV & XLSX oder nur XLSX). Wenn der CSV-Anhang das Größenlimit für E-Mails überschreitet und "CSV & XLSX" ausgewählt ist, fällt die E-Mail auf die Excel-Arbeitsmappe allein zurück.
Einstellungen zum E-Mail-Versand
Das Senden eines E-Mail-Berichts ist optional und erfolgt nur, wenn ein Empfänger (EmailTo) angegeben ist. Die Absenderadresse wird aus der RJReport.EmailSender Mandanteneinstellung übernommen.
Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über die Graph API zu senden, müssen Sie in der Runbook-Anpassung eine vorhandene E-Mail-Adresse konfigurieren.
Siehe die RealmJoin Report Settings-Dokumentation für Details zu allen verfügbaren Einstellungen.
E-Mail-Branding
Die Bericht-E-Mail berücksichtigt optional die RJReport.Branding.* Mandanteneinstellungen:
Kopf- und Fußzeilenbild – öffentliche HTTPS-URLs, PNG/JPEG/GIF, max. 200 KB jeweils
Fußzeilenlink – Ziel des Fußzeilenbilds
Akzent- und Textfarbe – 6-stellige Hex-Werte, z. B.
#0052cc
Wenn diese Einstellungen nicht konfiguriert sind, werden die standardmäßigen RealmJoin-Grafiken und -Farben verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert niemals die Bericht-E-Mail – stattdessen wird der entsprechende Standardwert verwendet.
Einrichtungsanweisungen und Bildanforderungen: E-Mail-Branding.
Speicherort
Organisation → Anwendungen → Bericht über ablaufende Anwendungsanmeldeinformationen (geplant)
Vollständiger Runbook-Name
rjgit-org_applications_report-expiring-application-credentials_scheduled
Details
Version
1.3.0
Erforderliche Module
RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.5.2)
Planbar
ja
Berechtigungen
Anwendungsberechtigungen
Typ: Microsoft Graph
Application.Read.All
Liest alle App-Registrierungen, um die Ablaufdaten von Zertifikaten und Geheimnissen zu ermitteln
Mail.Send (optional — Funktion: E-Mail-Bericht)
Sendet die Berichts-E-Mail über Send-RjReportEmail, wenn EmailTo konfiguriert ist
Organization.Read.All
Liest /organization für den Tenant-Namen und die ID im Bericht
Parameter
listOnlyExpiring
Wenn nur Anmeldeinformationen aufgelistet werden sollen, die innerhalb der angegebenen Anzahl von Tagen ablaufen, wählen Sie „Nur Anmeldeinformationen auflisten, die bald ablaufen“ (Endwert: true). Wenn Sie alle Anmeldeinformationen unabhängig von ihrem Ablaufdatum auflisten möchten, wählen Sie „Alle Anmeldeinformationen auflisten“ (Endwert: false).
Erforderlich
falsch
Standardwert
Wahr
Typ
Boolesch
Portal-Optionen
Nur Anmeldeinformationen auflisten, die bald ablaufen
wahr
Alle Anmeldeinformationen auflisten
falsch
Tage
Die Anzahl der Tage vor Ablauf einer Anmeldeinformation, ab der sie als „kurz vor dem Ablauf stehend“ gilt.
Erforderlich
falsch
Standardwert
30
Typ
Int32
Anzeigename im Portal
Tage vor Ablauf der Anmeldeinformation
CredentialType
Nach Anmeldeinformationstyp filtern: „Beide“ (Standard), „ClientSecrets“ oder „Zertifikate“.
Erforderlich
falsch
Standardwert
Beide
Typ
Zeichenfolge
Anzeigename im Portal
Anmeldeinformationstyp-Filter
Portal-Optionen
Client Secrets und Zertifikate
Beide
Nur Client Secrets
ClientSecrets
Nur Zertifikate
Zertifikate
ApplicationIds
Optional - durch Kommas getrennte Liste von Anwendungs-IDs, um die Anmeldeinformationen zu filtern.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Anzeigename im Portal
Anwendungs-IDs
ReportFileFormat
Steuert, welche Berichtdateiformate erzeugt und bereitgestellt werden: "nur CSV", "CSV & XLSX" (Standard) oder "nur XLSX".
Erforderlich
falsch
Standardwert
CSV & XLSX
Typ
Zeichenfolge
Anzeigename im Portal
Berichtdateiformat
Portal-Optionen
CSV & XLSX
nur CSV
nur XLSX
CreateDownloadLink
Wenn aktiviert, werden die Berichtdateien in ein Azure Storage Account hochgeladen und zeitlich begrenzte Download-Links zurückgegeben. Standardmäßig deaktiviert.
Erforderlich
falsch
Standardwert
Falsch
Typ
Boolesch
Anzeigename im Portal
Einen Datei-Download-Link erstellen (Bericht in den Speicher hochladen)?
Portal-Optionen
Ja - Bericht hochladen und einen Download-Link zurückgeben
wahr
Nein - keinen Download-Link erstellen
falsch
ContainerName
Name des Speicherkontext-Containers, der für den Upload verwendet wird. Pro Runbook konfiguriert (keine globale RJReport-Einstellung).
Erforderlich
falsch
Standardwert
report-expiring-app-credentials
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorgabemäßig über die Runbook-Anpassung festgelegt)
ResourceGroupName
Ressourcengruppe, die das Speicherkonto enthält. Stammt aus den Mandanten-Einstellungen von RJReport.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorgabemäßig über die Runbook-Anpassung festgelegt)
StorageAccountName
Name des Speicherkontos, das für den Upload verwendet wird. Stammt aus den Mandanten-Einstellungen von RJReport.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorgabemäßig über die Runbook-Anpassung festgelegt)
LinkExpiryDays
Anzahl der Tage, bis der generierte Download-Link abläuft. Stammt aus den Mandanten-Einstellungen von RJReport.
Erforderlich
falsch
Standardwert
6
Typ
Int32
Im Portal ausgeblendet
ja (vorgabemäßig über die Runbook-Anpassung festgelegt)
EmailTo
Falls angegeben, wird eine E-Mail mit dem Bericht an die bereitgestellte(n) Adresse(n) gesendet. Kann eine einzelne Adresse oder mehrere durch Kommas getrennte Adressen (string) sein. Die Funktion sendet aus Datenschutzgründen einzelne E-Mails an jeden Empfänger.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Anzeigename im Portal
E-Mail-Adresse(n) des Empfängers
EmailFrom
Die Absender-E-Mail-Adresse. Diese muss in der Runbook-Anpassung konfiguriert werden.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorgabemäßig über die Runbook-Anpassung festgelegt)
BrandingHeaderImageUrl
Optionale öffentliche HTTPS-URL eines benutzerdefinierten Kopfzeilenbilds (PNG/JPEG/GIF, max. 200 KB) für die Bericht-E-Mail. Stammt aus der Mandanteneinstellung RJReport.Branding.HeaderImageUrl. Wenn leer, wird die standardmäßige RealmJoin-Kopfzeilengrafik verwendet.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorgabemäßig über die Runbook-Anpassung festgelegt)
BrandingFooterImageUrl
Optionale öffentliche HTTPS-URL eines benutzerdefinierten Fußzeilenbilds (PNG/JPEG/GIF, max. 200 KB) für die Bericht-E-Mail. Stammt aus der Mandanteneinstellung RJReport.Branding.FooterImageUrl. Wenn leer, wird die standardmäßige RealmJoin-Fußzeilengrafik verwendet.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorgabemäßig über die Runbook-Anpassung festgelegt)
BrandingFooterLink
Optionale URL, auf die das Fußzeilenbild verweist. Stammt aus der Mandanteneinstellung RJReport.Branding.FooterLink. Wenn leer, wird der Standardlink (https://www.realmjoin.com) verwendet.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorgabemäßig über die Runbook-Anpassung festgelegt)
BrandingAccentColor
Optionale Überschreibung der Akzentfarbe (6-stelliger Hex-Wert, z. B. '#0052cc') für die Bericht-E-Mail-Vorlage. Stammt aus der Mandanteneinstellung RJReport.Branding.AccentColor. Wenn leer oder ungültig, wird die standardmäßige RealmJoin-Akzentfarbe verwendet.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorgabemäßig über die Runbook-Anpassung festgelegt)
BrandingTextColor
Optionale Überschreibung der Textfarbe (6-stelliger Hex-Wert) für die Bericht-E-Mail-Vorlage. Stammt aus der Mandanteneinstellung RJReport.Branding.TextColor. Wenn leer oder ungültig, wird die standardmäßige RealmJoin-Textfarbe verwendet.
Erforderlich
falsch
Standardwert
Typ
Zeichenfolge
Im Portal ausgeblendet
ja (vorgabemäßig über die Runbook-Anpassung festgelegt)
Zuletzt aktualisiert
War das hilfreich?