期限切れのアプリケーション資格情報をレポート（スケジュール済み）
アプリ登録の有効期限が近いクライアント シークレットと証明書をレポート
説明
アプリケーション登録のクライアント シークレットと証明書を、有効期限とともに一覧表示します。この一覧は、指定した日数以内に期限切れとなる資格情報や特定のアプリケーションに限定できます。結果は実行の Output Data タブにも表として表示されます。変更は行われません。レポートはメールで送信するか、ダウンロードリンクとして提供できます。
資格情報のステータス
各資格情報には、期限まで残りの日数に基づくステータスが付与されます:
期限切れ - 有効期限日が過ぎています（すべての資格情報を一覧表示する場合のみ表示）
Critical - 7日以内に期限切れ
Warning - 〜日以内に期限切れ 期限切れまでの日数 期限切れ間近の資格情報のみを一覧表示する場合、すべての資格情報を一覧表示する場合は30日以内
有効 - それ以降に期限切れ（すべての資格情報を一覧表示する場合のみ表示）
を有効にすると、 期限切れ間近の資格情報のみを一覧表示、すでに期限切れの資格情報は除外されます。 期限切れまでの日数 は、すべての資格情報を一覧表示する場合は使用されません。
レポートの配信
レポート ファイルは、配信方法が次の レポートの配信 オプション（メールおよび/またはダウンロードリンク）で選択された場合にのみ生成されます。次に Output Dataのみ 選択すると、結果は RealmJoin ポータルの Output Data タブで直接読み取られます。概要テーブルと、ステータスごとのテーブル 1 つ（期限切れの資格情報, クリティカルな資格情報, 警告の資格情報, 有効な資格情報）はそれぞれ Excel にもエクスポートできます。レポート ファイルにはすべての列が含まれます。メール配信とダウンロードリンクの生成は独立しており、組み合わせることができます。
ダウンロードリンクの場合、レポート ファイルは、次で構成された Azure の Storage Account にアップロードされます。 RJReport.StorageAccount.* テナント設定に保存され、期限付きの SAS ダウンロードリンクが返されます。ストレージへのアップロードは Automation account のマネージド ID で認証され、その ID には Storage Account Contributor 対象の Storage Account に対する RBAC ロール（これは Azure RBAC の割り当てであり、Graph のアプリケーション権限ではありません）。
いずれの資格情報もフィルターに一致しない場合、ファイルは作成されません。メール配信を選択している場合は、添付なしでメールは送信されます。
次より前に作成されたスケジュールは、 レポートの配信 オプションが存在していなかった頃からメール送信を継続します。保存済みの宛先だけでも、そのスケジュールのメール送信は有効になります。そのようなスケジュールを編集のために開くと、オプションには Output Dataのみと表示されます。保存する前にもう一度配信方法を選択してください。そうしないと、そのスケジュールはレポートの送信を停止します。
メール送信に関する設定
メール レポートの送信は任意で、次の場合にのみ行われます レポートもメール送信する または レポートもメール送信し、ダウンロードリンクを付ける として選択された場合 レポートの配信。その場合、宛先が必要です。送信者アドレスは次から取得されます RJReport.EmailSender Tenant 設定から取得されます。
この runbook は Microsoft Graph API を使用してメールを送信します。Graph API 経由でメールを送信するには、runbook のカスタマイズで既存のメール アドレスを設定する必要があります。
詳細については RealmJoin Report Settings のドキュメント を参照してください。
メールのブランド設定
レポート メールでは、任意の RJReport.Branding.* Tenant 設定が使用されます:
ヘッダーおよびフッター画像 - 公開 HTTPS URL、PNG/JPEG/GIF、各最大 200 KB
フッター リンク - フッター画像の対象
アクセント カラーとテキスト カラー - 6桁の16進値、例:
#0052cc
これらの設定が構成されていない場合は、既定の RealmJoin のグラフィックと色が使用されます。ダウンロードまたは検証できない画像、あるいは無効な色値があっても、レポートのメール送信が妨げられることはありません。代わりに対応する既定値が使用されます。
設定手順と画像要件: メールのブランド設定.
場所
Organization → Applications → 期限切れ間近のアプリケーション資格情報レポート（スケジュール済み）
Runbook の完全名
rjgit-org_applications_report-expiring-application-credentials_scheduled
詳細
バージョン
1.5.0
必要なモジュール
RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.5.2)
スケジュール可能
はい
権限
アプリケーションの権限
種類: Microsoft Graph
Application.Read.All
すべてのアプリケーション登録を読み取り、証明書とシークレットの有効期限を評価します
Mail.Send (任意 — 機能: メール レポート)
メール配信が選択されている場合、Send-RjRbReportEmail を介してレポートメールを送信します
Organization.Read.All (任意 — 機能: メール レポート)
メールの件名と本文に使用するテナントの表示名を読み取ります
権限に関する注意
Azure Storage Account: ターゲットの Storage Account に対する Automation Account のマネージド ID に 'Storage Account Contributor' ロールが必要です。アップロードでは listKeys を使用してアカウント キーを取得します（ダウンロードリンクのオプションでのみ必要）
パラメーター
listOnlyExpiring
「期限切れまでの日数」以内に期限切れとなる資格情報のみ、または期限切れのものを含むすべての資格情報。
必須
false
既定値
True
種類
ブール値
ポータルの表示名
どの資格情報？
ポータル オプション
期限切れ間近の資格情報のみを一覧表示
true
すべての資格情報を一覧表示
false
日数
この日数以内に期限切れとなる資格情報は、期限切れ間近と見なされます。すべての資格情報を一覧表示する場合は使用されません。
必須
false
既定値
30
種類
Int32
ポータルの表示名
期限切れまでの日数
CredentialType
クライアント シークレット、証明書、またはその両方。
必須
false
既定値
両方
種類
文字列
ポータルの表示名
資格情報の種類
ポータル オプション
クライアント シークレットと証明書
両方
クライアント シークレットのみ
ClientSecrets
証明書のみ
証明書
ApplicationIds
レポートをこれらのアプリケーション（クライアント）IDに制限します。複数ある場合はカンマで区切ってください。すべてのアプリケーションに対しては空欄のままにしてください。
必須
false
既定値
種類
文字列
ポータルの表示名
アプリケーション ID
ReportFileFormat
レポートを CSV、Excel ブック、またはその両方として配信します。
必須
false
既定値
CSV と XLSX
種類
文字列
ポータルの表示名
レポート ファイル形式
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
ポータル オプション
CSV と XLSX
CSV と XLSX
CSV のみ
CSV のみ
XLSX のみ
XLSX のみ
CreateDownloadLink
また、レポートをアップロードし、数日後に期限切れになるダウンロード リンクを返します。
必須
false
既定値
False
種類
ブール値
ポータルの表示名
ダウンロード リンクを作成しますか？
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
ContainerName
レポート ファイルをアップロードするストレージ コンテナー。runbook ごとに設定します。
必須
false
既定値
report-expiring-app-credentials
種類
文字列
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
ResourceGroupName
レポート アップロード用の Storage Account のリソース グループ。Tenant 設定 RJReport.StorageAccount.ResourceGroup から取得します。
必須
false
既定値
種類
文字列
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
StorageAccountName
レポート アップロード用の Storage Account。Tenant 設定 RJReport.StorageAccount.StorageAccountName から取得します。
必須
false
既定値
種類
文字列
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
LinkExpiryDays
ダウンロード リンクが有効なままの期間（日数）。Tenant 設定 RJReport.StorageAccount.LinkExpiryDays から取得します。
必須
false
既定値
6
種類
Int32
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
SendEmailReport
レポートを宛先のメール アドレスに送信します。
必須
false
既定値
False
種類
ブール値
ポータルの表示名
レポートをメールで送信しますか？
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
EmailTo
レポートをこれらの宛先に送信します。複数指定する場合はコンマで区切ってください。各受信者には個別のメールが送信されます。
必須
false
既定値
種類
文字列
ポータルの表示名
受信者のメール アドレス
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
EmailFrom
レポート メールの送信元アドレス。Tenant 設定 RJReport.EmailSender から取得されます。
必須
false
既定値
種類
文字列
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
BrandingHeaderImageUrl
レポート メールのヘッダー画像 (HTTPS URL、PNG/JPEG/GIF、最大 200 KB)。Tenant 設定 RJReport.Branding.HeaderImageUrl から取得されます。空欄の場合は既定の RealmJoin ヘッダーが使用されます。
必須
false
既定値
種類
文字列
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
BrandingFooterImageUrl
レポート メールのフッター画像 (HTTPS URL、PNG/JPEG/GIF、最大 200 KB)。Tenant 設定 RJReport.Branding.FooterImageUrl から取得されます。空欄の場合は既定の RealmJoin フッターが使用されます。
必須
false
既定値
種類
文字列
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
BrandingFooterLink
レポート メールのフッター画像のリンク先。Tenant 設定 RJReport.Branding.FooterLink から取得されます。空欄の場合は realmjoin.com が使用されます。
必須
false
既定値
種類
文字列
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
BrandingAccentColor
レポート メールのアクセント カラー。6 桁の 16 進値で指定します。Tenant 設定 RJReport.Branding.AccentColor から取得されます。空欄または無効な場合は RealmJoin の既定値が使用されます。
必須
false
既定値
種類
文字列
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
BrandingTextColor
レポート メールのテキスト カラー。6 桁の 16 進値で指定します。Tenant 設定 RJReport.Branding.TextColor から取得されます。空欄または無効な場合は RealmJoin の既定値が使用されます。
必須
false
既定値
種類
文字列
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
最終更新
役に立ちましたか？