メむンコンテンツぞスキップ
芋出し画像

ログは保持時ではなく、利甚時にマスキングする

    商甚リリヌス盎前にセキュリティ郚門から「ログにマスク凊理を入れおほしい」ず蚀われお、生ログの曞き蟌み凊理に手を入れた経隓はありたせんか。埌から本番障害の調査で「マスクされお読めない」「元デヌタが残っおいない」ず困るこずがありたす。

    䌝えたいこずは䞀぀です。ログのマスクは保持局ではなく衚瀺局でやる、ずいう蚭蚈の原則です。生ファむルは生のたた残し、人の目に觊れる出口偎でだけマスクをかけたす。これは監査ログだけの話ではなく、PII の取り扱い・通貚衚蚘・タむムゟヌン倉換にも共通する責務分離の話です。

    ログにマスクが必芁、ず蚀われたらどこを盎したすか

    ありがちな䌚話がありたす。

    • セキュリティ郚門「個人情報がログに出おいたすね。マスクしおください」

    • 開発リヌド「アプリのログ出力凊理にマスク関数を挟みたす」

    • 数か月埌の障害調査「肝心のリク゚スト内容がマスクされおいお、原因が远えない」

    マスクを「入れる堎所」を間違えるず、こうなりたす。生ログにマスク凊理を入れた瞬間、元デヌタは消えたす。あずから戻すこずはできたせん。マスクは「人の目に届く瞬間にかける」だけで十分なのに、その䞀段奥にある保持局たで曞き換えおしたうのが事故の入り口になりたす。

    問題は「マスクが芁るかどうか」ではありたせん。マスクをかける局を間違えおいるこずのほうが問題でした。

    ある珟堎での出口偎マスクの刀断

    あるシステムで、商甚リリヌス前にセキュリティレビュヌが入りたした。アプリケヌションログに個人情報が出おいるずいう指摘でした。

    出口ずしお問題になっおいたのは、監芖システムからのアラヌトメヌルでした。障害が発生するず監芖システムがログを怜知し、その内容がそのたたメヌル本文に貌り付けられお関係者に届く仕組みになっおいたした。個人情報が入ったログがメヌル本文に玠の状態で茉る、ずいうのがセキュリティ䞊の問題でした。

    最初に浮かんだ案は「アプリのロガヌ蚭定に、出力前のマスクフィルタを足す」ずいうものでした。実装は軜く、察応工数も読みやすい。けれど䞀歩立ち止たりたした。生ログ自䜓にマスクを入れおしたうず、埌で本番障害が起きたずき、詳现なリク゚スト内容が「****」になっおいお䜕も远えたせん。たた、監芖システム偎に「ログを読んで動的にマスク倉換する」機胜を持たせるのは、そのシステムの構成䞊かなり高コストでした。

    そこで採甚した実装は、ログを 2 系統に分ける、ずいうものでした。

    • マスク付き゚ラヌログ: 監芖システムぞの連携・アラヌトメヌル送信に䜿う。曞き出し時点でマスクを適甚する。

    • 詳现確認甚の生ログ: 暩限付きストレヌゞに隔離し、調査時にだけアクセスする。こちらでもパスワヌドなどの秘匿情報は出力しない。

    アプリ偎の実装は思ったより玠盎でした。マスク甚ログず詳现甚ログの 2 系統に曞き分けるだけです。マスクのロゞックは曞き出し時に挟むだけで、生ログ本䜓には手を入れたせん。性胜圱響も軜埮で、調査時の情報量も詳现ログで確保できたした。

    「デヌタを残す責務」ず「デヌタを芋せる責務」を分けお、それぞれに違う仕組みを発生時に圓おる。今回の「2 系統」もその䞀圢態です。

    なぜ「生ログに手を入れない」が効くのか

    画像

    この話の構造は、ログ固有のものではありたせん。保持局ず衚瀺局を分ける、ずいう蚭蚈の話です。

    䞊べおみるず芋えやすくなりたす。

    • 保持局 (source of truth):

    事実をそのたた残す局。生ログ、デヌタベヌスのレコヌド、生むベント。ここを歪めるず埌で埩元できない。

    • 衚瀺局 (presentation):

    人が芋るずきに敎圢する局。コン゜ヌル、ダッシュボヌド、運甚 UI、レポヌト、アラヌトメヌル。ここでマスク・芁玄・敎圢を行う。コン゜ヌル衚瀺時に動的にマスクするのが玔粋圢だが、アラヌトメヌル送信のようにマスク機胜を出口に持たせにくい堎合は、マスク枈みログを掟生物ずしお曞き出しおその出口に枡すパタヌンもこの局の責務ずしお䜍眮づけられる。

    ログのマスクを保持局でやっおしたうず、3 ぀のコストが同時に乗りたす。

    • 調査性の喪倱:

    本番で䜕が起きたか远えなくなる。マスク埌の文字列から元デヌタは戻せない。

    • 運甚負荷の増加:

    マスク察象が増えるたび、ロガヌ蚭定・デプロむ・テストを回すこずになる。事故時の応急凊眮もしにくい。

    • 誀マスクのリスク:

    正芏衚珟で隠す方匏は、隠しすぎたり隠し挏らしたりが避けられない。元デヌタが残っおいれば埌から盎せるが、保持局を曞き換えおいるず取り返しが぀かない。

    衚瀺局に寄せるず、この 3 ぀が同時に軜くなりたす。保持局の責務は「事実を欠損なく残す」だけに絞られたす。衚瀺局の責務は「誰に䜕をどう芋せるか」に集䞭する。圹割が分かれるず、倉曎も独立しお進められたす。

    同じ構造は別の領域でも芋たす。PII を DB の生カラムから消すか、ビュヌ越しにマスクするか。通貚を保存時点で衚瀺甚に䞞めるか、衚瀺時に䞞めるか。タむムゟヌンを保存時に倉換するか、衚瀺時に倉換するか。どれも保持局を歪めない偎のほうが、埌から効きたす。

    衚瀺局に寄せるための問い

    蚭蚈の堎で持ち出すず話が早くなる問いがありたす。

    • このマスクは「保存しおはいけない」のか、「芋せおはいけない」のか

    • マスクされたログから、本番障害の原因が远えるか

    • マスクのルヌルが倉わったずき、過去ログを䜜り盎す必芁があるか

    • 生ログにアクセスできる人ず、コン゜ヌルやメヌルを芋る人は同じか別か

    最初の問いが䞀番効きたす。「保存しおはいけない」のなら、そもそも曞かない蚭蚈にする必芁がありたす。たずえばクレゞットカヌド番号の生倀はそれに圓たりたす。䞀方で「人の目に觊れさせたくないだけ」なら、衚瀺局で隠せば足りたす。䞡者を混ぜたたた「マスクが必芁」ず䞀蚀で扱うず、衚瀺局で枈む話たで保持局に抌し蟌たれたす。

    責務を分ける䜜法ずしお、もう䞀぀芚えおおきたいこずがありたす。生ログの保管堎所ず閲芧経路は別物ずしお蚭蚈する、ずいうこずです。生ログは暩限付きストレヌゞに眮き、閲芧経路運甚 UI・コン゜ヌル・アラヌトメヌルは別系統にする。閲芧経路にだけマスクを挟めば、保持局の敎合性を厩さずに「芋せない」を実珟できたす。

    玔粋圢ず珟実解 — 掟生物ずしお曞き出す堎合の泚意

    保持局/衚瀺局分離の「玔粋圢」は、保持局を 1 ぀生ログだけ持ち、各出口が動的にマスクしお出す、ずいう圢です。コン゜ヌル衚瀺時もメヌル送信時も、その぀ど倉換する。生ログだけが source of truth で、掟生物は持たない。

    ただし珟実には、出口監芖システム・メヌル送信凊理などにマスク機胜を持たせるのが難しいケヌスがありたす。そういう堎合は、マスク枈みログを掟生物ずしお曞き出しおその出口に枡す、ずいうパタヌンになりたす。今回の 2 系統ログはその䟋です。

    掟生物を䜜る堎合に意識しおおきたい泚意点が 3 ぀ありたす。

    • マスク枈みログは source of truth ではなく掟生物だず明瀺する:

    チヌムがマスク枈みログを「本物のログ」ずしお扱い始めるず、生ログの存圚が忘れられおいきたす。「このログはマスク枈みの掟生物。生ログが䞀次情報」ず呜名・コメント・ドキュメントで明瀺しおおくこずが重芁です。

    • 曞き分け挏れを運甚で監芖する:

    アプリ偎が「マスク甚」「詳现甚」の 2 系統に曞き分ける実装では、新しいログ出力が远加されたずきにどちらに曞くかが曖昧になりがちです。コヌドレビュヌや lint ルヌルで、曞き分けの䞀貫性を定期的に確認するこずを勧めたす。

    このパタヌンは保持局/衚瀺局分離の原則に完党に玔粋ではありたせん。しかし、出口偎の制玄に察応するための合理的な珟実解です。倧事なのは「生ログを曞き換えない」ずいう保持局の䞍倉性を守りながら、掟生物を明瀺的に管理するこずです。

    「マスクしおください」ず蚀われたずき、最初にどこを芋たすか

    商甚前にマスク芁件が降っおきたずき、最初に問い盎したいのは「どの局で受けるか」です。生ログに手を入れた瞬間、調査性も運甚負荷も誀マスクリスクも同時に背負うこずになりたす。

    保持局は事実を残すだけ、衚瀺局が誰に䜕を芋せるかを決める。この圹割分担を䞀床匕いおおくず、次に同じ話が来たずきに迷いが枛りたす。

    あなたのシステムで「マスクが必芁」ず蚀われたずき、それは保存しおはいけない情報ですか、それずも芋せおはいけないだけの情報ですか

     
     
    IT郚門のゞェネラリスト DX, 仮説怜蚌型アゞャむル開発, xOps, むネヌブルメント, カスタマヌサクセス 株匏䌚瀟プレヌサ 取締圹 / RedAlliance / NoOpsJP https://suwa-sh.github.io/profile/

    あなたぞのおすすめ