ログ管理

Azure Monitorへのログ記録を有効にする

バージョン3.0以降、SCEPmanおよびCertificate MasterはMicrosoftのLog Ingestion APIを使用してログをAzure Monitorに書き込みます。これにはデータを保持して分析を可能にするLog Analyticsワークスペースの概念と、App Serviceとログストレージの間を仲介するデータ収集ルールが用いられます。これにより、SCEPmanがLAWにアクセスするためのRBACベースの権限を含む、よりモダンなアプローチが可能になります。

Log Analyticsワークスペースの作成およびデータ収集ルールの構成は、次を実行することで自動的に行われます Complete-SCEPmanInstallation SCEPman PowerShellモジュールの。

NAC ソリューションが Intune デバイス ID を基にデバイスを識別するために使用されます。値は次のようにする必要があります： デフォルトの保持期間 Log Analyticsテーブルに保存されるデータの期間は 30日です。異なる保持期間が必要な場合は、テーブル「SCEPman_CL」の構成を適宜調整してください。

Data Collector APIの再有効化

何らかの理由で以前のAPIを再導入したい場合、Log Ingestion関連のApp Serviceの変数を削除し、Data Collector APIで使用する変数を再度追加することで可能です。

削除する 変数:

• AppConfig:LoggingConfig:DataCollectionEndpointUri

• AppConfig:LoggingConfig:RuleId

追加する変数:

• AppConfig:LoggingConfig:WorkspaceId

• AppConfig:LoggingConfig:SharedKey

SCEPmanは再起動後に設定を自動的に読み取り、再びData Collector APIを利用します。

KQLクエリの例

SCEPmanインスタンスの問題を確認する

SCEPman_CL
| where Level == "Warn" or Level == "Error" or Level == "Fatal"

選択した期間におけるエンドポイント別の発行済み証明書数

このクエリは、ログにLog Ingestion APIを使用しているSCEPman 3.0以降で動作することが保証されています。このクエリが使用できなくなるようなSCEPmanの変更は破壊的変更と見なされます。

SCEPman_CL
| where Level == "Info" and Message startswith_cs "Issued a certificate with serial number"
| project Message, RequestBase = trim_end('/', replace_string(replace_string(replace_regex(RequestUrl_s, "(/pkiclient\\.exe)?(\\?operation=PKIOperation(&message=.+)?)?", ""),"certsrv/mscep/mscep.dll","intune"),"step/enrollment","activedirectory"))
| summarize IssuanceCount = count() by Endpoint = extract("/([a-zA-Z]+)$", 1, RequestBase)

古いLog Ingestion APIを使用している場合は、次の少し調整したクエリを使用してください：

SCEPman_CL
| where Level == "Info" and Message startswith_cs "Issued a certificate with serial number"
| project Message, RequestBase = trim_end('/', replace_string(replace_string(replace_regex(RequestUrl, "(/pkiclient\\.exe)?(\\?operation=PKIOperation(&message=.+)?)?", ""),"certsrv/mscep/mscep.dll","intune"),"step/enrollment","activedirectory"))
| summarize IssuanceCount = count() by Endpoint = extract("/([a-zA-Z]+)$", 1, RequestBase)

SCEPman 2.8以降では、発行された各証明書ごとにログメッセージが「Issued a certificate with serial number 」で始まるInfoレベルのログエントリが正確に1つ存在し、その後にシリアル番号が続きます。しかし、解決不能な 二軍問題のため、作成された証明書が要求元に到達しない、または他の種類のエラーにより実際の登録が阻害されることがあります。同様に、重大なエラーが発生した場合、対応するデータベースエントリがないログエントリが存在する、またはその逆が発生することがあります。

OCSPチェックを伴う重複しない証明書

let map_certtype = datatable(serial_start:string, readable:string)
[
  "40", "Intune デバイス",
  "41", "Intune デバイス",
  "42", "Intune 非準拠デバイス",
  "50", "Static",
  "51", "Static",
  "60", "Intune ユーザー",
  "61", "Intune ユーザー",
  "64", "Jamf ユーザー",
  "65", "Jamf ユーザー",
  "6C", "デバイス上の Jamf ユーザー",
  "6D", "デバイス上の Jamf ユーザー",
  "70", "ドメインコントローラー",
  "7C", "コンピュータ上の Jamf ユーザー",
  "7D", "コンピュータ上の Jamf ユーザー",
  "54", "Jamf コンピュータ",
  "55", "Jamf コンピュータ",
  "44", "Jamf デバイス",
  "45", "Jamf デバイス"
];
SCEPman_CL
| where LogCategory == "Scepman.Server.Controllers.OcspController" and Level == "Info"
| where Message startswith_cs "OCSP Response"
| project serial = extract("Serial Number ([A-F0-9]+)", 1, Message)
| distinct serial
| extend serial_start = substring(serial,0,2)
| join kind=leftouter map_certtype on serial_start
| summarize count() by (readable)

まだData Collector APIを使用している場合は、代わりにこのクエリを使用してください：

let map_certtype = datatable(serial_start:string, readable:string)
[
  "40", "Intune デバイス",
  "41", "Intune デバイス",
  "42", "Intune 非準拠デバイス",
  "50", "Static",
  "51", "Static",
  "60", "Intune ユーザー",
  "61", "Intune ユーザー",
  "64", "Jamf ユーザー",
  "65", "Jamf ユーザー",
  "6C", "デバイス上の Jamf ユーザー",
  "6D", "デバイス上の Jamf ユーザー",
  "70", "ドメインコントローラー",
  "7C", "コンピュータ上の Jamf ユーザー",
  "7D", "コンピュータ上の Jamf ユーザー",
  "54", "Jamf コンピュータ",
  "55", "Jamf コンピュータ",
  "44", "Jamf デバイス",
  "45", "Jamf デバイス"
];
SCEPman_CL
| where LogCategory_s == "Scepman.Server.Controllers.OcspController" and Level == "Info"
| where Message startswith_cs "OCSP Response"
| project serial = extract("Serial Number ([A-F0-9]+)", 1, Message)
| distinct serial
| extend serial_start = substring(serial,0,2)
| join kind=leftouter map_certtype on serial_start
| summarize count() by (readable)