サイト取得

# ==========================================================
# アクセス権の棚卸：サイトID一覧（CSV）のサイトごとに、サイト取得APIでアクセス権を取得し、
# 「どのサイトで、誰に、どの権限が付いているか」を1行1件のCSVに出力します。
# 権限を継承しているサイトは、継承元のアクセス権を取得します。
# ==========================================================
import csv
from pathlib import Path

import requests

# ===== 設定 =====
# APIキーは、テナント管理者のものを使ってください（サイト取得APIの前提）
BASE_URL = "【URL】"
API_KEY = "【APIキー】"
INPUT_CSV = Path("./sites.csv")                  # 1行目は見出し「SiteId」
OUTPUT_CSV = Path("./site_permissions.csv")
PAGE_SIZE = 200

# 権限値はビットの和。標準のパターンは値が完全に一致するときのみ、その名前にする
PERMISSION_BITS = [
    (1, "読取り"), (2, "作成"), (4, "更新"), (8, "削除"), (16, "メール送信"),
    (32, "エクスポート"), (64, "インポート"), (128, "サイトの管理"), (256, "権限の管理"),
]
PATTERNS = {1: "読取専用", 31: "書き込み", 255: "リーダー", 511: "管理者"}
KIND_NAMES = {"Dept": "組織", "Group": "グループ", "User": "ユーザー"}
HEADER = (["サイトID", "タイトル", "継承元サイトID", "継承元タイトル", "対象種別", "対象ID", "対象名", "権限パターン"]
          + [name for _, name in PERMISSION_BITS] + ["備考"])


def api_post(path, payload=None):
    """Pleasanter APIへPOSTする。レスポンスのJSONを返す（HTTPエラーでも本文を返す）"""
    response = requests.post(
        f"{BASE_URL}{path}",
        json={"ApiVersion": 1.1, "ApiKey": API_KEY, **(payload or {})},
        headers={"Content-Type": "application/json"},
        timeout=60,
    )
    return response.status_code, response.json()


def fetch_all(path):
    """取得件数に応じてOffsetを進めながら、全件を取得する"""
    rows = []
    while True:
        _, body = api_post(path, {"Offset": len(rows), "PageSize": PAGE_SIZE})
        page = body["Response"]["Data"]
        rows.extend(page)
        if len(page) == 0 or len(rows) >= body["Response"]["TotalCount"]:
            return rows


def load_names():
    """組織・グループ・ユーザーの「ID → (名前, 無効か)」を、最初に1回だけ取得する"""
    return {
        "Dept": {d["DeptId"]: (d["DeptName"], d.get("Disabled")) for d in fetch_all("/api/depts/get")},
        "Group": {g["GroupId"]: (g["GroupName"], g.get("Disabled")) for g in fetch_all("/api/groups/get")},
        "User": {u["UserId"]: (u["Name"], u.get("Disabled")) for u in fetch_all("/api/users/get")},
    }


def get_site(site_id, cache):
    """サイトを取得する（同じサイトは1回のみ）。失敗したら (None, メッセージ) を返す"""
    if site_id not in cache:
        status, body = api_post(f"/api/items/{site_id}/getsite")
        cache[site_id] = (body["Response"]["Data"], "") if status == 200 else (None, body.get("Message", f"HTTP {status}"))
    return cache[site_id]


def read_site_ids(path):
    """入力のサイトIDを、重複を除いて読んだ順に返す"""
    with open(path, encoding="utf-8-sig", newline="") as f:
        ids = [int(row["SiteId"]) for row in csv.DictReader(f) if row["SiteId"].strip()]
    return list(dict.fromkeys(ids))


def permission_cells(value):
    """権限値を、パターン名と9つの個別権限（付いていれば〇）に分解する"""
    return [PATTERNS.get(value, "特殊")] + ["〇" if value & bit else "" for bit, _ in PERMISSION_BITS]


def site_rows(site_id, names, cache):
    """1サイト分の出力行を返す"""
    site, error = get_site(site_id, cache)
    if site is None:
        return [[site_id, "", "", "", "", "", "", ""] + [""] * len(PERMISSION_BITS) + [error]]
    # 継承しているサイトの Permissions は空になるため、継承元（継承の大元）のものを使う
    inherit_id = int(site["InheritPermission"])
    source, error = (site, "") if inherit_id == site_id else get_site(inherit_id, cache)
    if source is None:
        return [[site_id, site["Title"], inherit_id, "", "", "", "", ""] + [""] * len(PERMISSION_BITS) + [f"継承元を取得できません：{error}"]]
    head = [site_id, site["Title"], inherit_id, source["Title"]]
    permissions = source.get("Permissions") or []
    if not permissions:
        # 誰にも権限が付いていないサイトも、一覧で分かるように1行出す
        return [head + ["", "", "", ""] + [""] * len(PERMISSION_BITS) + ["アクセス権なし"]]
    rows = []
    for permission in permissions:
        kind, target_id, value = permission.split(",")
        name, disabled = names[kind].get(int(target_id), ("", False))
        rows.append(head + [KIND_NAMES.get(kind, kind), int(target_id), name]
                    + permission_cells(int(value)) + ["無効" if disabled else ""])
    return rows


def main():
    names = load_names()
    cache = {}
    rows = [row for site_id in read_site_ids(INPUT_CSV) for row in site_rows(site_id, names, cache)]
    # Excel でそのまま開けるように、BOM付きのUTF-8で書く
    with open(OUTPUT_CSV, "w", encoding="utf-8-sig", newline="") as f:
        writer = csv.writer(f)
        writer.writerow(HEADER)
        writer.writerows(rows)
    print(f"{len(rows)} 行を {OUTPUT_CSV} に出力しました。")


if __name__ == "__main__":
    main()