スキップしてメイン コンテンツに移動

Workspace ONE UEMでWindowsデバイスのログ収集


WS1 UEM管理下のWindowsデバイスのトラブルシューティング時などに有用なログ収集の方法を紹介します。
また、実際のトラブルシュート時の小技なども紹介したいと思います。

大まかな流れは以下の通りです。
    1．WS1 UEM管理コンソールからリモートでログ取得
    2．取得したログの確認
    3．小技


1．WS1 UEM管理コンソールからリモートでログ取得

ログ収集を行う際、管理者目線で言うと、可能であればユーザー側の操作なしにリモートでかつサイレントで収集できることが望ましいと思います。

WS1 UEMではリモートでログ収集を行う機能が備わっているため、その機能を利用します。

WebブラウザでWorkspace ONE UEMの管理コンソールにログインし、ログ取得対象のデバイス詳細画面で[その他のアクション]>[デバイスログを要求]をクリックします。


[デバイスログを要求]画面で、[HUB]を選択した状態で[保存]をクリックします。


同じ手順を繰り返し、次は[システム]を選択した状態で[保存]をクリックします。
【補足】
[HUB]の方は文字通りIntelligent Hubのログの収集で、[システム]の方はOSレベルのログを一部収集することができます。



2．取得したログの確認

次に実際に取得されたログを確認してみます。
先ほどログ取得を実行したデバイスの詳細画面で[その他]>[添付ファイル]をクリックします。


[ファイル]タブをクリックすると収集されたログの一覧が表示されます。
ファイル名の接頭辞部分(Hub_とかSystem_の部分)は、ログ取得実行時に選択した種別に対応したものになります。
[spanned]という文字列が含まれているファイルはサイズの関係で複数のファイルに分割された状態になっているログです。
ファイル名のリンクをクリックするとダウンロードができます。
【補足】
ファイル分割はされないような機能改善がどこかのバージョンで実施されたため今後は不要かもしれません。分割されていても次の手順で対応が可能です。


[spanned]が名前に含まれるファイルはそのままだと中身を見ることができないため一手間必要になります。
まずは、末尾にzXXを含むファイルの拡張子部分を削除します。すると右側の画像のようになるはずです。
【補足】
_spanned.zXXというファイルが無ければ(=分割されていなければ)この対応は不要です。


残ったZIPファイルを右クリック後、7-Zip>[ここに展開]をクリックします。


すると、解凍されたフォルダが現れます。
階層を掘っていくとログZipファイルの本体が現れるので、これを解凍します。


これでデバイス側に蓄積されたログが見放題です。



3．小技

前述の解凍したZIPファイルの中身を見ると、少なくともIntelligent Hubのログフォルダである[C:\ProgramData\Airwatch\UnifiedAgent\Logs]はZIPファイルの中に含まれているようです。

Hubでデフォルトで出力されるようなログはこの前述の方法だけ収集できますが、それ以外の、例えばOSのイベントログや他アプリケーションのログを取得することはできません。（OSイベントログについては一部含まれるものもありますが、分量としてはある程度限定されます。）

ただし、[C:\ProgramData\Airwatch\UnifiedAgent\Logs]フォルダに含まれてさえいればこの機能で収集することができるので、例えば特定のレジストリが取得したい、とかOSレベルのイベントログの確認が必要、他アプリのログが欲しいなどの場合は、上記のフォルダに対象のログをエクスポートするコマンドをスクリプト機能などで実行しておき、その後Hubのログ収集を実行することで、Hubとは直接関連しないログも収集することが可能です。

例として、以下のようなコマンドをスクリプト機能やプロダクトプロビジョニングなどで事前に実行しておき、その後Hubのログ収集機能を実行することで、Hubに関連しないレジストリ値やログでもデバイス側の操作無しに収集することが可能です。

■レジストリエクスポート
reg export HKLM\SOFTWARE\myapp C:\ProgramData\Airwatch\UnifiedAgent\Logs\myapp.reg
■イベントログエクスポート
wevtutil export-log system C:\ProgramData\Airwatch\UnifiedAgent\Logs\System_YYYYMMDD.evtx

上記の方法で、HKLM¥SOFTWARE¥Microsoftのレジストリとシステムイベントログを実際に検証機のHubのログ収集機能で取得してみた結果が以下です。



WS1関連の問題と思いきや、調査を進めるうちに他のアプリ起因の問題の可能性が出てくる、なんてことは往々にしてあると思いますが、そんな時でもWS1の機能をうまく活用することで調査を円滑にすすることができるのではないかと思います。

コメント

コメントを投稿

このブログの人気の投稿

Workspace ONE Accessに証明書認証でログイン

Workspace ONE AccessではSaaSなどのサービスへのアクセス管理ができますが、クライアント証明書認証の機能も備わっています。 ここでは、Workspace ONE UEMから配信した証明書を使用して、Workspace ONE Accessに証明書認証でログインする、ということをやってみます。 まずは、Workspace ONE UEMコンソールでの作業です。 すべての設定＞システム＞エンタープライズ統合＞Workspace ONE Access＞構成 へ移動し、「 エクスポート 」をクリックしてAirWatch認証局のルート証明書をエクスポートします。 次に、Windows向けにWorkspace ONE Access認証用証明書プロファイルを作成してデバイスに対して配信します。 SCEPペイロードを選択し、「 資格情報ソース 」は「 AirWatch認証局 」を選択します。証明書テンプレートは「 証明書（クラウド展開） 」です。 【補足】 上記のプロファイルで配信した証明書は 秘密キーのエクスポートができない ようになっているため、使い回しを防ぐことができます。つまり、私用のデバイスにインポートし直してログインしてしまおう...ということはできない仕組みになっているワケですね。 次はWorkspace ONE Accessの管理コンソールでの作業です。 IDとアクセス管理＞管理＞認証方法をクリックし、「 証明書（クラウドデプロイ） 」の設定を変更します。（UEMのプロファイルで選択した証明書テンプレートと同じ名前ですね。若干の誤差はありますが...） 始めに、「 証明書アダプタを有効にする 」にチェックを入れ、「 ルートおよび中間CA証明書 」のところには先ほどWorkspace ONE UEMからエクスポートした証明書をアップロードし、「 証明書の失効を有効にする 」にもチェックを入れておきます。 【補足】 公的認証局であっても、ここでルート証明書をアップロードしない限り証明書認証はできないので、今回の例では Workspace ONE UEM内部の認証局から発行されている証明書以外では認証できない 構成にすることができます。 少し下にスクロールして「 OCSPの失効を有効にする 」にチェックを入れ、「 OCSPレスポンダの署名証明書 」には...
コメントを投稿
続きを読む

Workspace ONE AccessからServiceNowにシングルサインオン(SAML)

以前、Workspace ONEと他システム間で、 OpenID Connect で連携する内容をポストしましたが、今回は SAML を利用したシングルサインオンの構成を検証してみました。 ServiceNow と SAML連携 して、WS1のポータルからシングルサインオンする構成を試してみます。 大枠の流れとしては以下の通りです。      1．ServiceNow(SP)のSAML認証設定          1.1． WS1 AccessからSAML連携に必要な情報を取得           1.2．SAML認証設定      2．WS1 Access(IDP)でSAML認証設定      3．動作確認 1.ServiceNow側(SP)でSAML認証設定 まずは、今回の構成ではSP(Service Provider)となるServiceNow側でSAMLによるシングルサインオンを可能とするように構成します。 1.1．WS1 Accessから S AML連携に必要な情報を取得 まずは、WS1 AccessのIDPメタデータのURLを取得します。 [カタログ]>[Webアプリケーション]をクリック後、[設定]をクリックします。 左ペインから[SAMLメタデータ]をクリック後、IDPメタデータの[URLをコピー]をクリックします。 クリップボードにコピーされるので、テキストエディタにでも貼り付けておきます。 次に、WS1 AccessのIDP署名証明書を取得します。 左ペインから、[SAMLメタデータ]をクリック後、署名証明書の[ダウンロード]をクリックします。 こんなファイルがダウンロードされます。 1.2．SAML認証設定 続いて、ServiceNow側のSAML認証設定を行います。 ServiceNowの管理コンソールにログインし、検索バーに[saml]と入力後、[SAML2 Single Sign-On]配下の[Certificate]をクリックします。 後で、使用するため先ほどダウンロードした、[signingCertificate.cer]をテキストエデ...
コメントを投稿
続きを読む

自分のデバイスは自分で管理

Workspace ONE UENにはセルフサービスポータル（SSP）という機能があります。 名前の通りセルフサービスで自身に紐付いているデバイスに対して色々できるポータルで、デバイスのステータスを確認したり、位置情報を確認してみたり、コマンドを実行したりと様々なことができます。 色々できるとなると、逆に誤操作などでデバイスワイプを実行してしまい意図せず初期化してしまったりするのではないか...という懸念が出てきますが、WS1 UEMのセルフサービスポータルではユーザーが実施可能な操作をカスタマイズできます。 例えば、あくまで情報参照用とするためにデバイス情報の表示の権限だけ与えておいたり、紛失したときの対策のために加入解除操作はできるようにしておく、など運用要件によりカスタマイズして利用できるというワケです。 ここでは、加入解除のみを実行できるようにカスタマイズしたSSPにログインし、ユーザー目線で実際に自分のデバイスを加入解除する、ということをやってみます。 実際にありそうなシーンと言えば、あまり考えたくありませんが、夜中に会社支給のデバイスの紛失に気付いてしまったときとかですかね... まずは、Workspace ONE UEMのSSPにログインします。 WebブラウザでWorkspace ONE UEMコンソールのURLの末尾にmydeviceを付けてEnterキーを押します。「https://cnXXX.awmdm.com/mydevice」みたいな感じです。 アクセス後は、ログイン方法などを選択後次ヘ進み、ユーザー名パスワードを入力してログインします。 今回は事前に権限を極限まで絞っているため「 企業情報ワイプ 」のみ表示されていますので、これをクリックします。 【補足】 画像に映っている通り、自分に紐付くデバイスが複数存在する場合もすべてSSPから管理できます。 すると、対象のデバイスで加入解除が実行され、企業データが削除されます。 ちなみに、上記の動作確認ではSSPの権限をかなり限定して企業情報ワイプしかできないようにしてますが、特に権限を限定しなければ「 企業情報ワイプ 」以外にも「 デバイスの位置情報を確認 」など様々なオプションが実行できますし、「 詳細に進む 」をクリックすると... デバイスの順守状態や適切にプロファイルが適用されているか、...
コメントを投稿
続きを読む