{
  "schema": "varexis-public-evidence-record/0.3",
  "generated_at_utc": "2026-10-24T17:09:18.442Z",
  "record_id": "VXI-EXT-PROCUREMENT-GITHUB-INSTALLATION-TOKEN-NARROWING-GRANT-CEILING-01-v1",
  "record_kind": "external_reference",
  "title": "GitHub installation token narrowing",
  "system": "GitHub",
  "evidence_family": "vendor_evidence_review",
  "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
  "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
  "canonical_question": "Can a GitHub installation token request broader permissions or repositories than the app installation allows?",
  "near_questions": [
    "Can GitHub installation tokens be narrower than the app grant?",
    "What does omitting repositories do when minting an installation token?",
    "Can a GitHub App token request an ungranted permission?",
    "Does an organization owner enlarge an installation token’s scope?"
  ],
  "supported_claims": [
    {
      "claim": "GitHub allows installation-token requests to narrow repositories and permissions, but not exceed the installation’s grants. Omitting those restrictions gives the token the installation’s permitted repositories and permissions. The documented token lifetime is one hour; an organization owner’s identity does not enlarge this token’s grant ceiling.",
      "reliance": "DOCUMENTED_CAPABILITY_ONLY"
    }
  ],
  "not_demonstrated_claims": [
    "Authority beyond the app installation through administrator status",
    "The actual installation and issued token restrictions are unknown.",
    "Buyer deployment testing, live runtime enforcement, certification or permission to act",
    "Expanded capabilities or licences for existing INDEX executables"
  ],
  "public_summary": "GitHub allows installation-token requests to narrow repositories and permissions, but not exceed the installation’s grants. Omitting those restrictions gives the token the installation’s permitted repositories and permissions. The documented token lifetime is one hour; an organization owner’s identity does not enlarge this token’s grant ceiling.",
  "related_record_ids": [],
  "source_review": {
    "source_type": "official_external_documentation",
    "source_title": "Generating an installation access token for a GitHub App - GitHub Docs",
    "source_url": "https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app",
    "checked_on": "2026-10-24",
    "candidate_record_id": "VXI-EXT-PROCUREMENT-GITHUB-INSTALLATION-TOKEN-NARROWING-GRANT-CEILING-01-v1",
    "candidate_record_sha256": "e0022e5189fc9843f8ea44ac823654a5119e4f2b0269b5f7ba6bc783d1ad9f5a",
    "method": "Primary documentation reviewed for the published bounded statement.",
    "deployment_tested_by_varexis": false,
    "revalidation": "The delivered snapshot preserves the review date shown. Recheck current primary documentation and deployment context before relying on present applicability; payment does not trigger fresh research."
  },
  "answer_policy": {
    "classification": "DOCUMENTED_WITH_DEPLOYMENT_BOUNDARY",
    "bounded_answer": "GitHub allows installation-token requests to narrow repositories and permissions, but not exceed the installation’s grants. Omitting those restrictions gives the token the installation’s permitted repositories and permissions. The documented token lifetime is one hour; an organization owner’s identity does not enlarge this token’s grant ceiling.",
    "required_buyer_context": "App and installation identity; Requested repository and permission restrictions; Installation grants and returned expiration/scope metadata. Buyer deployment not inspected.",
    "missing_evidence": "A broader claim needs evidence matching the intended use. Payment does not upgrade the evidence state."
  },
  "private_boundary": "Raw logs, thresholds, private paths, source code, protected mechanisms and reconstruction-level details are excluded from public and paid delivery.",
  "decision_profile": {
    "schema": "varexis-vendor-evidence-review/1",
    "review_status": "documentation_review_only",
    "checked_on": "2026-10-24",
    "claim_to_check": "Can a GitHub installation token request broader permissions or repositories than the app installation allows?",
    "documented_statement": {
      "status": "documented",
      "statement": "GitHub allows installation-token requests to narrow repositories and permissions, but not exceed the installation’s grants. Omitting those restrictions gives the token the installation’s permitted repositories and permissions. The documented token lifetime is one hour; an organization owner’s identity does not enlarge this token’s grant ceiling.",
      "source_ids": [
        "github-install-token"
      ]
    },
    "review_inference": {
      "status": "review_inference",
      "statement": "Request only the approved subset and retain the resulting token-scope evidence.",
      "source_ids": [
        "github-install-token"
      ]
    },
    "buyer_evidence_required": [
      "App and installation identity",
      "Requested repository and permission restrictions",
      "Installation grants and returned expiration/scope metadata"
    ],
    "review_condition": {
      "status": "varexis_review_policy",
      "statement": "Refuse a least-privilege claim without comparing the request and resulting token with the installation grant."
    },
    "unknowns": "The actual installation and issued token restrictions are unknown.",
    "unknown_finding": {
      "status": "unknown",
      "statement": "The actual installation and issued token restrictions are unknown."
    },
    "evidence_sources": [
      {
        "source_id": "github-install-token",
        "url": "https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app",
        "final_url": "https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app",
        "status": 200,
        "captured_at_utc": "2026-10-24T16:47:22.002Z",
        "sha256": "21416ae3de325f739fef1da1b14ce792aa5ea5f8a3de4975500117703c01cd93",
        "bytes": 184826,
        "title": "Generating an installation access token for a GitHub App - GitHub Docs",
        "hash_basis": "Decoded HTTP response body bytes",
        "rights_review": "Factual paraphrase and source metadata only; raw source retained privately and not redistributed.",
        "checked_on": "2026-10-24",
        "capture_status": 200,
        "claim_review_completed": true,
        "reviewed_sections": [
          "Repository and permission restrictions",
          "Token expiry"
        ],
        "version_context": "Rolling official documentation captured 2026-10-24; installed API/SDK version, account tier and buyer configuration require verification."
      }
    ],
    "observed_deployment": false,
    "commercial_reliance_boundary": "Documentation review only; the buyer must establish applicability and actual outcomes. INDEX does not inspect or control the deployment.",
    "paid_value": {
      "decision_context": "Issue task-scoped GitHub credentials without assuming the app grant is already minimal.",
      "free": "Complete review, sources, practical questions and limitations; may be saved locally.",
      "single_request": "Existing server-saved version-bound route snapshot for later authenticated retrieval.",
      "evidence_receipt": "The same snapshot plus the existing unsigned delivery receipt.",
      "excluded": [
        "Fresh vendor research",
        "Continuous monitoring or change alerts",
        "Testing the buyer configuration",
        "Private evidence or vendor certification"
      ],
      "integrity": "Hashes identify content versions; they do not prove truth or provide a signature."
    },
    "revalidation": {
      "trigger": "A saved purchase does not recheck the source or buyer configuration.",
      "specific_watch": "Recheck the documented behavior, product version and buyer evidence before relying on a current outcome."
    },
    "buyer_relevance": "Issue task-scoped GitHub credentials without assuming the app grant is already minimal.",
    "refusal_conditions": [
      "Refuse a least-privilege claim without comparing the request and resulting token with the installation grant."
    ]
  },
  "niche": {
    "niche_id": "agent-authority-action-evidence",
    "label": "Agent Authority & Action Evidence",
    "classification_id": "governance",
    "classification_label": "Agent Governance & Policy Boundaries",
    "topic_id": "governance",
    "buyer_intent": "Issue task-scoped GitHub credentials without assuming the app grant is already minimal.",
    "comparison_role": "supplementary_discovery"
  },
  "paid_access_note": "The full published answer and boundaries are free. Paid access saves the selected route and source versions, with an unsigned receipt when purchased. Preview coverage before paying. Fresh research, bespoke assessment and protected evidence are excluded.",
  "service_route": {
    "request_guide": "/varexis-index/request.html",
    "request_workflow": "/varexis-index/request-workflow.json",
    "service_id": "single_request",
    "service_routes_url": "/varexis-index/service-routes.json",
    "payment_required": true,
    "availability_endpoint": "/api/index/capabilities",
    "operational_status": "AUTOMATIC_SERVICE_CAPABILITIES_GATED",
    "checkout_url": "/index-access"
  },
  "authority_boundary": "VAREXIS-INDEX informs evidence reliance. It does not provide advice, certification, deployment authority, security assurance, production approval, or guarantee.",
  "human_page": "/varexis-index/catalog.html#github-installation-token-narrowing-grant-ceiling",
  "machine_readable_record": "/varexis-index/records/github-installation-token-narrowing-grant-ceiling.json"
}
