AKASHIC ZERO

Playwright / Chrome 永続プロファイルと OAuth の「無音ログイン切れ」を防ぐ──Python 標準ライブラリだけで作る有効期限・0600権限監視

複数の外部サービス(Google Search Console / YouTube OAuth / Qiita / Zenn / SMTP / Playwright 永続プロファイルで運用する Web サービス等)を連携運用していると、**ある日突然セッションやトークンが切れて無音で失敗し続ける**

一次検証Fail-ClosedSQLite実測ログ無料公開

# Playwright / Chrome 永続プロファイルと OAuth の「無音ログイン切れ」を防ぐ──Python 標準ライブラリだけで作る有効期限・0600権限監視

複数の外部サービス(Google Search Console / YouTube OAuth / Qiita / Zenn / SMTP / Playwright 永続プロファイルで運用する Web サービス等)を連携運用していると、ある日突然セッションやトークンが切れて無音で失敗し続ける 事故が起きます。

本記事では、外部ライブラリ不要・Python 3.11+ 標準ライブラリのみ で以下を一括監視し、systemd タイマーで 6 時間ごとに自動点検する実装パターンと、実運用で踏んだ 3 つのハマりどころを共有します。

  1. Chrome 永続プロファイル(Default/Cookies)から 認証 Cookie の実有効期限(残日数) を読み取る
  2. 認証ファイルが他ユーザーから読めない **0600 権限** かを監査する
  3. OAuth2 refresh_token の実更新・API 疎通・SMTP STARTTLS 認証を秘密値ゼロ出力で検証する

1. Chrome の Cookies SQLite から有効期限(残日数)を安全に読む

Playwright の launchPersistentContext などで使う Chrome プロファイルでは、Cookie の値は暗号化されていても **host_key・name・expires_utc は平文で SQLite に保存** されています。つまり、復号処理もブラウザ起動も不要で有効期限を正確に取得できます。

注意点は 2 つです。

  1. **Chrome 起動中と競合しないよう一時ディレクトリへコピーしてから mode=ro で開く**
  2. **expires_utc は Windows FILETIME 基準(1601-01-01 からのマイクロ秒)** のため、UNIX エポックとの差 11644473600 * 1_000_000 を引く必要がある
import shutil
import sqlite3
import tempfile
from datetime import datetime, timezone
from pathlib import Path
from typing import Any

CHROME_EPOCH_OFFSET_US = 11644473600 * 1_000_000


def read_chrome_cookie_expiries(
    cookies_db: Path,
    host_like: str,
    names: tuple[str, ...],
    warn_days: int = 14,
) -> dict[str, Any]:
    if not cookies_db.is_file():
        return {"status": "FAIL", "cookies": {}, "min_days_remaining": None}

    with tempfile.TemporaryDirectory() as td:
        tmp_db = Path(td) / "Cookies"
        shutil.copy2(cookies_db, tmp_db)
        con = sqlite3.connect(f"file:{tmp_db}?mode=ro", uri=True)
        try:
            ph = ",".join("?" for _ in names)
            rows = con.execute(
                f"SELECT host_key, name, expires_utc FROM cookies "
                f"WHERE host_key LIKE ? AND name IN ({ph})",
                (host_like, *names),
            ).fetchall()
        finally:
            con.close()

    now = datetime.now(timezone.utc)
    out: dict[str, Any] = {}
    for host, name, exp_us in rows:
        if exp_us and int(exp_us) > CHROME_EPOCH_OFFSET_US:
            ts = (int(exp_us) - CHROME_EPOCH_OFFSET_US) / 1_000_000.0
            dt = datetime.fromtimestamp(ts, tz=timezone.utc)
            out[f"{host}:{name}"] = {
                "expires_at": dt.strftime("%Y-%m-%dT%H:%M:%SZ"),
                "days_remaining": round((dt - now).total_seconds() / 86400.0, 1),
            }
        else:
            out[f"{host}:{name}"] = {"expires_at": "session", "days_remaining": None}

    min_days = min(
        (v["days_remaining"] for v in out.values() if isinstance(v["days_remaining"], (int, float))),
        default=None,
    )
    if not out or (min_days is not None and min_days <= 0):
        status = "FAIL"
    elif min_days is not None and min_days < warn_days:
        status = "WARN"
    else:
        status = "OK"
    return {"status": status, "cookies": out, "min_days_remaining": min_days}

実運用で踏んだ罠①:補助 Cookie と主セッション Cookie の混同

実際のプロファイルを監査したところ、短期自動更新される GraphQL 用補助 Cookie が -2.1日(期限切れ)と出た一方、ログイン本体である主セッション Cookie は 残り 89.8 日 で健全でした。監視対象には「ログイン本体を司る主セッション Cookie のみ」を明示指定しないと、誤検知(偽陽性)が発生します。


2. 秘密ファイルの 0600 権限監査と OAuth / SMTP 実疎通

トークンファイルを置いただけで終わらせず、**他ユーザー読取禁止(mode & 0o077 == 0) と 実エンドポイント疎通** をセットで検証します。

import smtplib
import ssl
import stat
from pathlib import Path


def is_secret_file_secure(path: Path) -> bool:
    if not path.is_file():
        return False
    return (stat.S_IMODE(path.stat().st_mode) & 0o077) == 0


def verify_smtp_starttls(host: str, port: int, user: str, password: str) -> None:
    ctx = ssl.create_default_context()
    with smtplib.SMTP(host, port, timeout=15) as srv:
        srv.ehlo()
        srv.starttls(context=ctx)
        srv.ehlo()
        srv.login(user, password)

OAuth2 の refresh_token についても、アクセストークンの再発行を 6 時間〜数日ごとに実行しておくことで、Google 系の「6ヶ月未使用による自動失効」を防ぎながらリアルタイムに失効検知できます。


3. 実運用で踏んだ罠②③:systemd の PATH 欠落と HTTP レスポンス切り捨て

罠②:対話シェルでは動くのに systemd で FileNotFoundError: 'gcloud'

systemd ユーザーユニットの既定 PATH には ~/.local/google-cloud-sdk/bin や nvm 配下の node/npx が含まれません。スクリプト側で shutil.which()+フォールバック絶対パス解決を行うと同時に、ユニットファイル側にも Environment="PATH=..." を明示する必要があります。

[Service]
Type=oneshot
Environment="PATH=/usr/local/bin:/usr/bin:/bin:%h/.local/google-cloud-sdk/bin"
ExecStart=/usr/bin/python3 /path/to/promo_channels_health.py

罠③:HTTP ヘルスチェックの JSON 切り捨てと WAF 403

  • ログ肥大化防止のために HTTP レスポンス本文を [:400] で切り捨ててから json.loads() すると、プロフィール JSON が 400 文字を超えた瞬間にパース失敗します(読取上限は 32KB 程度に取り、ログ表示時だけ丸める)。
  • 一部の Cloudflare WAF 配下サイトでは Python urllib の既定 TLS/UA に対して HTTP 403 を返すことがあるため、公開到達確認には curl を使うと誤検知を避けられます。

4. まとめ

  • 外部チャネルを増やすほど「無音ログイン切れ」と「初期ダミー設定の放置(例:SMTP の初期サンプル値が残ったまま)」が最大の運用リスクになる
  • Python 標準ライブラリだけで Cookie 実残日数・0600 権限・OAuth 実更新・SMTP STARTTLS を 10 秒以内で全件監査でき、秘密値を一切出力せずに状態 JSON を定期更新できる

関連リソース

  • 本記事のWeb版(無料公開): https://www.akashiczero.com/articles/20261119-playwright-chrome-cookie-oauth-expiry-audit.html
  • 無料技術シミュレーター(LLM VRAM / Fail-Closed ROI 試算): https://www.akashiczero.com/#tools
  • 検証済み本番防御コード全集 v2.0(BOOTH ZIP+PDF版・¥500): https://akashiczero.booth.pm/items/9182761
  • 無料技術続報(メール配信・1クリック解除可): https://crm.akashiczero.com/subscription/form
  • 検証済み本番防御コード全集 v2.0(統合CLI+6モジュール+テスト7/7 PASS+テンプレート一式・note ¥500): https://note.com/shiroi1229/n/n6a67d472363b
FREE TECHNICAL BRIEFING

実測ポストモーテム・修正パッチの続報を受け取る

一次検証データ・Fail-Closed 境界実装・新規無料記事の公開時にのみ配信します(広告なし・いつでも1クリック解除可能)。プライバシーポリシーに同意のうえご登録ください。

購読管理フォームを別タブで開く ↗