非アクティブなエンタープライズ アプリケーションを一覧表示
最近サインインされていないエンタープライズ アプリケーションを一覧表示
説明
指定した日数の間サインインされていないエンタープライズ アプリケーションと、これまで一度も使用されていないアプリケーションを見つけ、まだ必要かどうかを判断できるようにします。チェックでは Service Principal サインイン アクティビティ レポートを使用し、各アプリケーションの最後のサインイン日を保持します。変更は行われません。Microsoft Entra ID P1 または P2 ライセンスが必要です。レポートはメールで送信することも、ダウンロード リンクとして提供することもできます。
サインイン データの判定方法
この runbook は Microsoft Entra Service Principal サインイン アクティビティ レポート（/beta/reports/servicePrincipalSignInActivities）. このレポートには、各 Service Principal の最終サインイン日が、委任フローとアプリ専用フローの両方について、クライアントとしてもリソースとしても保持されるため、個々のサインイン イベントを 7 日間（Microsoft Entra ID Free）または 30 日間（Microsoft Entra ID P1/P2）しか保持しないサインイン ログの保持期間に制限されません。したがって、90 日というしきい値も 7 日と同様に信頼性高く評価できます。
Tenant 内のすべてのエンタープライズ アプリケーション（Service Principal）は、次の 2 つのリストのいずれか 1 つに正確に割り当てられます：
非アクティブなアプリケーション - 最後のサインインが、設定された日数より前である
サインイン記録のないアプリケーション - レポートにそのアプリケーションのサインインが含まれていない
このレポートは Usage & insights Microsoft Entra ID における Microsoft Entra ID P1 または P2 ライセンスが必要です。これがないと、runbook はエラーで停止します。
runbook はデータのみを読み取ります。列挙されたアプリケーションは変更しません。
レポートの配信
レポート ファイルは、配信方法が次の レポートの配信 オプション（メールおよび/またはダウンロードリンク）で選択された場合にのみ生成されます。次に 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 のグラフィックと色が使用されます。ダウンロードまたは検証できない画像、あるいは無効な色値があっても、レポートのメール送信が妨げられることはありません。代わりに対応する既定値が使用されます。
設定手順と画像要件: メールのブランド設定.
場所
組織 → アプリケーション → 非アクティブなエンタープライズ アプリケーションを一覧表示
Runbook の完全名
rjgit-org_applications_list-inactive-enterprise-applications
詳細
バージョン
1.5.0
必要なモジュール
RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0) Az.Accounts (>= 5.5.2)
スケジュール可能
いいえ
権限
アプリケーションの権限
種類: Microsoft Graph
AuditLog.Read.All
各アプリケーションの最終サインイン日について Service Principal サインイン アクティビティ レポートを読み取ります
Directory.Read.All
すべてのエンタープライズ アプリケーションの Service Principal を一覧表示します
Mail.Send (任意 — 機能: メール レポート)
メール配信が選択されている場合、Send-RjRbReportEmail を介してレポートメールを送信します
Organization.Read.All (任意 — 機能: メール レポート)
レポートのメール送信用に Tenant 表示名を読み取ります
権限に関する注意
Azure Storage Account: ターゲットの Storage Account に対する Automation Account のマネージド ID に 'Storage Account Contributor' ロールが必要です。アップロードでは listKeys を使用してアカウント キーを取得します（ダウンロードリンクのオプションでのみ必要）
パラメーター
日数
少なくともこれだけの日数サインインのないアプリケーションが、非アクティブとして一覧表示されます。
必須
false
既定値
90
種類
Int32
ポータルの表示名
サインインなしの日数
ReportFileFormat
レポートを CSV、Excel ブック、またはその両方として配信します。
必須
false
既定値
CSV と XLSX
種類
文字列
ポータルの表示名
レポート ファイル形式
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
ポータル オプション
CSV と XLSX
CSV と XLSX
CSV のみ
CSV のみ
XLSX のみ
XLSX のみ
CreateDownloadLink
また、レポートをアップロードし、数日後に期限切れになるダウンロード リンクを返します。
必須
false
既定値
False
種類
ブール値
ポータルの表示名
ダウンロード リンクを作成しますか？
ポータルでは非表示
はい（runbook のカスタマイズで事前設定）
ContainerName
レポート ファイルをアップロードするストレージ コンテナー。runbook ごとに設定します。
必須
false
既定値
list-inactive-enterprise-applications
種類
文字列
ポータルでは非表示
はい（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 のカスタマイズで事前設定）
最終更新
役に立ちましたか？