# Playwright / Chrome 永続プロファイルと OAuth の「無音ログイン切れ」を防ぐ──Python 標準ライブラリだけで作る有効期限・0600権限監視
複数の外部サービス(Google Search Console / YouTube OAuth / Qiita / Zenn / SMTP / Playwright 永続プロファイルで運用する Web サービス等)を連携運用していると、ある日突然セッションやトークンが切れて無音で失敗し続ける 事故が起きます。
本記事では、外部ライブラリ不要・Python 3.11+ 標準ライブラリのみ で以下を一括監視し、systemd タイマーで 6 時間ごとに自動点検する実装パターンと、実運用で踏んだ 3 つのハマりどころを共有します。
- Chrome 永続プロファイル(
Default/Cookies)から 認証 Cookie の実有効期限(残日数) を読み取る - 認証ファイルが他ユーザーから読めない **
0600権限** かを監査する - OAuth2
refresh_tokenの実更新・API 疎通・SMTP STARTTLS 認証を秘密値ゼロ出力で検証する
1. Chrome の Cookies SQLite から有効期限(残日数)を安全に読む
Playwright の launchPersistentContext などで使う Chrome プロファイルでは、Cookie の値は暗号化されていても **host_key・name・expires_utc は平文で SQLite に保存** されています。つまり、復号処理もブラウザ起動も不要で有効期限を正確に取得できます。
注意点は 2 つです。
- **Chrome 起動中と競合しないよう一時ディレクトリへコピーしてから
mode=roで開く** - **
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