知識マップ: ネットワークドライブとUNCパスの落とし穴 ── 業務アプリでファイルサーバー(共有フォルダ)を扱う実務

記事「ネットワークドライブとUNCパスの落とし穴 ── 業務アプリでファイルサーバー(共有フォルダ)を扱う実務」の主張を、概念と関係(エッジ)に分解した知識グラフの全体です。各関係には根拠・確認日・確度が付いています。

業務アプリから共有フォルダーへ出力・監視するトラブルの多くは、コードのバグではなくWindowsの仕組みに根ざしている。ドライブ文字はログオンセッション単位のシンボリックリンクにすぎず、別ユーザー・UAC昇格・サービスからは見えないため、サービスや異なるセキュリティコンテキストのプロセスはUNCパスを使うべきとされる。サービスからの認証は実行アカウントで決まり、LocalSystem/NetworkServiceはコンピューターの資格情報、LocalServiceは匿名資格情報になるため、ドメイン環境ではドメインアカウントかgMSAに共有側の権限を与えるのが実務の標準になる。同じサーバーへの複数資格情報の同時接続はエラー1219で失敗する仕様があり、共有は遅い・切れる・いないことがあるという前提のもとtemp→renameでの公開やidempotencyな再処理、FileSystemWatcherとポーリングの併用で設計しておく必要がある。

flowchart LR
    accTitle: ネットワークドライブとUNCパスの落とし穴の知識マップ
    accDescr: ドライブ文字がログオンセッション単位でしか通用しないこと、サービスの実行アカウントごとに共有側の認証が変わること、エラー1219や共有の切断・取りこぼしを前提にした設計が必要になることの関係を示す図
    unc_path["UNCパス"]
    logon_session["ログオンセッション"]
    mapped_network_drive["ネットワークドライブ(マップされたドライブ文字)"]
    windows_service["Windowsサービス"]
    uac_elevation["UAC昇格(管理者として実行)"]
    enablelinkedconnections["EnableLinkedConnectionsレジストリ値"]
    localsystem_account["LocalSystemアカウント"]
    active_directory["Active Directory(AD DS)"]
    networkservice_account["NetworkServiceアカウント"]
    localservice_account["LocalServiceアカウント"]
    gmsa["gMSA(group Managed Service Account)"]
    domain_controller["ドメインコントローラー"]
    domain_account["ドメインアカウント"]
    kerberos["Kerberos"]
    spn["SPN"]
    network_redirector["ネットワークリダイレクター"]
    smb_445["SMB(TCP 445)"]
    net_use_command["net use コマンド"]
    error_1219["エラー1219(ERROR_SESSION_CREDENTIAL_CONFLICT)"]
    wnetaddconnection2["WNetAddConnection2"]
    credential_manager["資格情報マネージャー(cmdkey)"]
    impersonation["偽装(impersonation)"]
    filesystemwatcher["FileSystemWatcher"]
    smb_share_file_handoff["共有フォルダ(SMB)越しのファイル連携"]
    polling_full_scan["定期フルスキャン(ポーリング)"]
    temp_then_rename_publish["temp -> close -> rename/replaceでの公開"]
    idempotent_processing["idempotency(冪等性)を前提にした処理"]
    partial_write_read["書き込み途中ファイルの読み込み事故"]
    file_exists_method["File.Exists"]
    smb_autodisconnect["SMBのアイドル接続自動切断(autodisconnect)"]
    mapped_network_drive -->|"に保存される"| logon_session
    unc_path -->|"推奨される対応"| windows_service
    mapped_network_drive -->|"用いるのは非推奨"| windows_service
    windows_service -->|"前提とする"| logon_session
    uac_elevation -.->|"両立しない"| mapped_network_drive
    enablelinkedconnections -->|"用いるのは非推奨"| uac_elevation
    unc_path -->|"推奨される対応"| uac_elevation
    localsystem_account -.->|"前提とする"| active_directory
    networkservice_account -.->|"前提とする"| active_directory
    localservice_account -->|"用いるのは非推奨"| unc_path
    gmsa -->|"推奨される対応"| windows_service
    gmsa -->|"前提とする"| active_directory
    gmsa -->|"前提とする"| domain_controller
    domain_account -->|"推奨される対応"| windows_service
    kerberos -->|"前提とする"| spn
    kerberos -.->|"前提とする"| domain_controller
    unc_path -->|"前提とする"| network_redirector
    network_redirector -.->|"利用する"| smb_445
    net_use_command -->|"前提とする"| unc_path
    net_use_command -->|"原因になり得る"| error_1219
    wnetaddconnection2 -->|"推奨される対応"| windows_service
    credential_manager -.->|"推奨される対応"| unc_path
    impersonation -->|"推奨される対応"| windows_service
    filesystemwatcher -->|"推奨される対応"| smb_share_file_handoff
    polling_full_scan -->|"推奨される対応"| filesystemwatcher
    temp_then_rename_publish -->|"推奨される対応"| smb_share_file_handoff
    idempotent_processing -->|"推奨される対応"| smb_share_file_handoff
    temp_then_rename_publish -->|"防止する"| partial_write_read
    file_exists_method -->|"用いるのは非推奨"| unc_path
    smb_share_file_handoff -->|"前提とする"| unc_path
    smb_share_file_handoff -.->|"原因になり得る"| smb_autodisconnect

概念間の関係(全31件)

図と同じ関係を文章でも列挙します。表示している文と機械可読な意味データ(RDFa)は同じ要素に載っています。確度が「確立した関係」のものは直接の関係として、「条件付きの関係」のものは成立条件つきの言明(rdf:Statement)として表現しています。

ネットワークドライブ(マップされたドライブ文字)はログオンセッションに保存されます。ドライブ文字はシステムグローバルではなく、ログオンセッションごとにAからZの一式が割り当てられる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
UNCパスはWindowsサービスに対する本記事の推奨です。サービスや異なるセキュリティコンテキストで動くプロセスがリモート資源にアクセスするときは、UNCパスを使うことが公式に推奨されている / 確度: 確立した関係 / 確認日: 2026-08-01 出典
ネットワークドライブ(マップされたドライブ文字)をWindowsサービスに用いることは推奨されません。サービス内でnet useやWNet系APIを使い実行時にドライブ文字をマップする実装は、資格情報の漏えいやサービス間の干渉の観点から推奨されない / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Windowsサービスはログオンセッションを前提とします。サービスをユーザーアカウントで構成しても、システムはサービス用に新しいログオンセッションを作るため、デスクトップ側のドライブマップは引き継がれない / 確度: 確立した関係 / 確認日: 2026-08-01 出典
UAC昇格(管理者として実行)はネットワークドライブ(マップされたドライブ文字)と両立しません。通常権限側のログオンスクリプトで張ったドライブマップは、UACで作られる昇格用の別ログオンセッションにはシンボリックリンクが共有されないため見えない。昇格したセッション内でマップし直せば昇格プロセスからも使える / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
EnableLinkedConnectionsレジストリ値をUAC昇格(管理者として実行)に用いることは推奨されません。EnableLinkedConnectionsは昇格時と通常時の両方のログオンセッションにドライブマップを共有させる回避策だが、Microsoftは非サポートを明記している / 確度: 確立した関係 / 確認日: 2026-08-01 出典
UNCパスはUAC昇格(管理者として実行)に対する本記事の推奨です。昇格プロセスでドライブマップが見えない問題は、非サポートのレジストリ回避策ではなくアプリのパスをUNCで持つことで解決するのが公式の推奨 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
LocalSystemアカウントはActive Directory(AD DS)を前提とします。LocalSystemはネットワーク上でコンピューターの資格情報として認証されるため、ドメイン環境ではコンピューターアカウントへの共有側の権限付与が要る / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
NetworkServiceアカウントはActive Directory(AD DS)を前提とします。NetworkServiceもLocalSystemと同じくコンピューターの資格情報でネットワーク認証されるため、共有側の権限付与にはドメイン環境が前提になる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
LocalServiceアカウントをUNCパスに用いることは推奨されません。LocalServiceはネットワーク上で匿名資格情報になるため、UNCパスの共有フォルダーへのアクセスには使えない / 確度: 確立した関係 / 確認日: 2026-08-01 出典
gMSA(group Managed Service Account)はWindowsサービスに対する本記事の推奨です。ドメイン環境で長期運用するサービスの実行アカウントには、パスワードをOSが自動管理するgMSAが推奨される / 確度: 確立した関係 / 確認日: 2026-08-01 出典
gMSA(group Managed Service Account)はActive Directory(AD DS)を前提とします。gMSAはActive Directoryドメインのアカウントであり、ワークグループ環境では選択肢にならない / 確度: 確立した関係 / 確認日: 2026-08-01 出典
gMSA(group Managed Service Account)はドメインコントローラーを前提とします。gMSAのパスワード生成には、ドメインコントローラー側のKDS(Key Distribution Service)ルートキーが必要 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
ドメインアカウントはWindowsサービスに対する本記事の推奨です。gMSAの前提が整わない場合、実務ではドメインアカウントを実行アカウントにするのが標準 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
KerberosはSPNを前提とします。Kerberos認証の環境でSMBクライアントが接続先のサービスチケットを要求するには、接続先ホスト名に対応するSPNが登録されている必要がある / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Kerberosはドメインコントローラーを前提とします。Active Directory環境のKerberos認証は、ドメインコントローラー上で動くKDCがチケットを発行することを前提とする。MITやHeimdalのようなAD以外のレルムでは、ドメインコントローラーを介さずKDCがチケットを発行する / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
UNCパスはネットワークリダイレクターを前提とします。UNCパス(\\server\share)への要求は、名前空間上の\Device\Mupというネットワークリダイレクターのデバイスオブジェクトを経由して運ばれる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
ネットワークリダイレクターはSMB(TCP 445)を利用します。SMBのリダイレクター(LanmanWorkstation)が運ぶファイル共有の要求は、SMB(TCP 445)のプロトコルとポートを使う。MUPはWebDAVリダイレクターなど別のプロバイダーにもUNC要求を振り分けるため、UNCすべてがSMBを通るわけではない / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
net use コマンドはUNCパスを前提とします。net useはUNCパスで指定した共有資源への接続を、実行したログオンセッションに確立する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
net use コマンドはエラー1219(ERROR_SESSION_CREDENTIAL_CONFLICT)の原因になることがあります。同じログオンセッションから同じサーバーへ、net use等で異なるユーザー名の接続を2つ目以降張ろうとすると、エラー1219(ERROR_SESSION_CREDENTIAL_CONFLICT)で失敗する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
WNetAddConnection2はWindowsサービスに対する本記事の推奨です。サーバープロセスがクライアントの資格情報でネットワーク資源に接続する戦略として、WNetAddConnection2による明示的な接続確立が公式ドキュメントに挙げられている / 確度: 確立した関係 / 確認日: 2026-08-01 出典
資格情報マネージャー(cmdkey)はUNCパスに対する本記事の推奨です。共有側にドメインアカウントの権限を割り当てられない場合、cmdkeyで保存した資格情報を使ってUNCパスへ認証する手段がある / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
偽装(impersonation)はWindowsサービスに対する本記事の推奨です。クライアントユーザーの権限でファイルサーバーへアクセスしたい場合、資格情報を抱え込むより偽装(impersonation)を使うことが公式に推奨されている / 確度: 確立した関係 / 確認日: 2026-08-01 出典
FileSystemWatcherは共有フォルダ(SMB)越しのファイル連携に対する本記事の推奨です。FileSystemWatcherはネットワークドライブやリモートコンピューター上のファイル監視をサポートし、共有フォルダー越しの連携で新着ファイルの検知に使われる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
定期フルスキャン(ポーリング)はFileSystemWatcherに対する本記事の推奨です。リモート共有のFileSystemWatcherは通知の取りこぼしがあるため、起動時・エラー時・定期のフルスキャン(ポーリング)を併用するのが実務の定石 / 確度: 確立した関係 / 確認日: 2026-08-01 出典
temp -> close -> rename/replaceでの公開は共有フォルダ(SMB)越しのファイル連携に対する本記事の推奨です。共有フォルダー越しのファイル連携では、close後のrenameで完成を公開するtemp->renameパターンが推奨される / 確度: 確立した関係 / 確認日: 2026-08-01 出典
idempotency(冪等性)を前提にした処理は共有フォルダ(SMB)越しのファイル連携に対する本記事の推奨です。共有は遅い・切れる・いないことがあるため、再処理しても壊れないidempotencyな設計が最後の砦になる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
temp -> close -> rename/replaceでの公開は書き込み途中ファイルの読み込み事故を防ぎます。close後のrenameでfinal名を公開するパターンにしておけば、受信側が書き込み途中のファイルを読んでしまう事故を防げる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
File.ExistsをUNCパスに用いることは推奨されません。File.Existsは権限不足やネットワーク到達不能時にも例外を出さずfalseを返すため、共有フォルダー相手では「ファイルが無い」と「サーバーに届かない」を区別できず、業務判断の分岐には使わないほうがよい / 確度: 確立した関係 / 確認日: 2026-08-01 出典
共有フォルダ(SMB)越しのファイル連携はUNCパスを前提とします。共有フォルダー越しのファイル連携は、UNCパスを介した接続を前提とする / 確度: 確立した関係 / 確認日: 2026-08-01 出典
共有フォルダ(SMB)越しのファイル連携はSMBのアイドル接続自動切断(autodisconnect)の原因になることがあります。共有フォルダーを介した連携は、アイドル状態が続くとサーバー側またはクライアント側のタイマーで接続が自動的に切断される / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典

主要概念の定義

UNCパス: \\サーバー名\共有名\...の形式で共有フォルダーの実体を指す、Windowsのユニバーサル命名規則によるパス表記。
ログオンセッション: ユーザーのログオンやサービスの起動のたびにOSが作る実行の文脈で、ドライブ文字のマップはログオンSIDに基づきこの単位で管理される。
ネットワークドライブ(マップされたドライブ文字): UNCパスの共有フォルダーに割り当てたドライブ文字(Z:など)で、実体はログオンセッション固有のシンボリックリンクオブジェクト(DosDevices)である。
Windowsサービス: ユーザーのサインインと無関係にバックグラウンドで動くWindowsのプロセス。
UAC昇格(管理者として実行): UAC有効な管理者ユーザーのログオン時に、権限を制限した通常トークンと完全な管理者トークンという、リンクされた2つのログオンセッションが作られる仕組み。
EnableLinkedConnectionsレジストリ値: UACのリンクされた2つのログオンセッション双方にドライブマップのシンボリックリンクを書き込ませるレジストリ回避策。Microsoftはシステムを安全でなくする可能性があるとして非サポートを明記している。
LocalSystemアカウント: サービスの実行アカウントの1つ。ローカルでは広範な特権を持つ一方、ネットワーク上ではコンピューターの資格情報としてリモートサーバーに認証される。
NetworkServiceアカウント: サービスの実行アカウントの1つ。ローカルの特権は最小限だが、ネットワーク上ではLocalSystemと同じくコンピューターの資格情報として認証される。
LocalServiceアカウント: サービスの実行アカウントの1つ。ネットワーク上では匿名資格情報として認証されるため、共有フォルダーへのアクセスには使えない。
gMSA(group Managed Service Account): パスワードの自動生成・自動更新とSPN管理の簡素化を提供するActive Directoryドメインのサービスアカウント。ドメインコントローラー側のKDSルートキーの準備を前提とする。
ドメインアカウント: Active Directoryドメインに属し、ドメインコントローラーで認証されるアカウント。NTLMでの認証はドメインコントローラーへのパススルー認証を伴う。
Kerberos: チケットによる一度だけの本人確認と相互認証を提供する認証プロトコル。Windows ServerはKerberos version 5と、公開鍵認証・認可データの転送・委任のための拡張を実装する。
ネットワークリダイレクター: \Device\Mupという単一のデバイスオブジェクトとして名前空間に存在し、UNCパス(\\server\share)の要求をネットワーク越しに運ぶコンポーネント。
net use コマンド: 指定したユーザー名でUNCパスの共有資源への接続を、実行したログオンセッションに確立するコマンド。サービス内での実行は資格情報の漏えいや干渉の観点から非推奨とされる。
WNetAddConnection2: クライアントの資格情報を指定してネットワーク資源への接続を確立できるWin32 API。ドライブ文字を割り当てないdeviceless接続にすれば、UNCパスのままアクセスできる。
資格情報マネージャー(cmdkey): サーバーごとの資格情報をユーザープロファイル単位で保存し、以後の認証時に自動的に提示する仕組み。サービスで使うにはその実行アカウントのコンテキストで登録する必要がある。
偽装(impersonation): サービスが、接続してきたクライアントユーザーの権限を借りてリモート資源にアクセスする仕組み。
FileSystemWatcher: .NETが提供する、ファイル・ディレクトリの作成・変更・削除・名前変更をイベントで通知するAPI。ディレクトリ通知はアプリが動いている間しか受け取れず、内部バッファのoverflowで個別通知を取りこぼすことがある。
定期フルスキャン(ポーリング): 変更通知に頼らず、対象フォルダーを一定間隔ですべて確認して変化を検出する監視方式。
temp -> close -> rename/replaceでの公開: 生成中のファイルをtemp名に閉じ込め、closeしたあとで同一ディレクトリ・同一ボリューム上のfinal名へrename/replaceする、書き込み途中のファイルを読ませないための公開パターン。
idempotency(冪等性)を前提にした処理: 同じ入力をもう一度処理しても結果が変わらない性質を前提に、排他が破れた場合の二重実行を処理済み台帳への記録で吸収する設計。
File.Exists: .NETでファイルの存在を確認するAPI。パス不正・権限不足・ディスク障害など理由を問わず例外を出さずfalseを返すため、共有フォルダー相手では「ファイルが無い」と「サーバーに届かない」を区別できない。
共有フォルダ(SMB)越しのファイル連携: SMB共有フォルダを介してtemp->rename公開やclaimを行う運用。同一共有内では原子性が保たれる一方、ボリュームをまたぐ移動・他プロセスによる開放中の失敗・タイムスタンプの不確実性・変更通知の取りこぼしが追加のリスクになる。

機械可読データ

JSON-LD / Turtle ── この記事の知識グラフ全体
概念一覧 / 語彙(述語)の定義

このページはサイトの知識グラフ(_data/knowledge/)から自動生成されています。誤りの指摘はお問い合わせからお願いします。