{
  "schema": "varexis-public-evidence-record/0.3",
  "generated_at_utc": "2026-10-17T10:49:29.433Z",
  "record_id": "VXI-EXT-PROCUREMENT-GITHUB-INSTALLATION-DOWNSCOPE-01-v1",
  "record_kind": "external_reference",
  "title": "GitHub Apps: Review the token actually issued",
  "system": "GitHub Apps",
  "evidence_family": "vendor_evidence_review",
  "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
  "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
  "canonical_question": "Does a GitHub App installation token automatically have the narrow scope intended for one agent task?",
  "near_questions": [
    "Which installation issued the token?",
    "Were repository restrictions requested?",
    "Were permission restrictions requested?",
    "What happens if restrictions are omitted?",
    "Can the token exceed the installation grant?",
    "Which repositories does the response identify?",
    "What permissions were actually returned?",
    "When does the token expire?",
    "Does the token match this agent task?",
    "Could a broad grant be inherited?",
    "Can scope be reviewed without sharing the secret?",
    "Can I retain the installation-token review?"
  ],
  "supported_claims": [
    {
      "claim": "GitHub allows repository and permission restrictions when generating installation tokens. Omitted restrictions inherit the documented installation or app scope, while requested rights cannot exceed the grant. The response reports token permissions, applicable repositories and expiry.",
      "reliance": "DOCUMENTED_CAPABILITY_ONLY"
    }
  ],
  "not_demonstrated_claims": [
    "Verified buyer configuration or effective access rights",
    "Independent execution, completeness or security testing",
    "Vendor certification, legal compliance or guaranteed suitability"
  ],
  "public_summary": "GitHub allows repository and permission restrictions when generating installation tokens. Omitted restrictions inherit the documented installation or app scope, while requested rights cannot exceed the grant. The response reports token permissions, applicable repositories and expiry.",
  "related_record_ids": [],
  "source_review": {
    "source_type": "official_external_documentation",
    "source_title": "GitHub: Generating an installation access token for a GitHub App",
    "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-17",
    "candidate_record_id": "VXI-EXT-PROCUREMENT-GITHUB-INSTALLATION-DOWNSCOPE-01-v1",
    "candidate_record_sha256": "7dfbbf4fc48582917cc418c33c7c030d97d26bc8c80c204023dcf158ba25b77b",
    "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 repository and permission restrictions when generating installation tokens. Omitted restrictions inherit the documented installation or app scope, while requested rights cannot exceed the grant. The response reports token permissions, applicable repositories and expiry.",
    "required_buyer_context": "Installation grant, token request restrictions and returned token scope. Effective buyer configuration and operational results were 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-17",
    "claim_to_check": "Does a GitHub App installation token automatically have the narrow scope intended for one agent task?",
    "documented_statement": {
      "status": "documented",
      "statement": "GitHub allows repository and permission restrictions when generating installation tokens. Omitted restrictions inherit the documented installation or app scope, while requested rights cannot exceed the grant. The response reports token permissions, applicable repositories and expiry.",
      "source_ids": [
        "github-token"
      ]
    },
    "buyer_evidence_required": [
      "Installation repositories and granted app permissions.",
      "Token-generation repository and permission parameters.",
      "Returned scope and expiry without exposing the token."
    ],
    "review_condition": {
      "status": "varexis_review_policy",
      "statement": "Review the issued scope against the task; do not infer downscoping from the task description."
    },
    "unknowns": "The buyer configuration, contract, effective entitlement and operational evidence have not been inspected. Missing evidence does not establish absence or failure of the feature.",
    "evidence_sources": [
      {
        "source_id": "github-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",
        "title": "GitHub: Generating an installation access token for a GitHub App",
        "checked_on": "2026-10-17",
        "sha256": "50d9e9c645ab810d36d967e1d885d944515fe17d9a25269ed5d89a2e43996d15",
        "bytes": 184827
      }
    ],
    "observed_deployment": false,
    "commercial_reliance_boundary": "Procurement evidence support only; no supplier clearance, legal conclusion, configuration audit or verification of the buyer's claim is supplied.",
    "paid_value": {
      "decision_context": "Does a GitHub App installation token automatically have the narrow scope intended for one agent task?",
      "free": "Complete review, practical questions, sources 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": "Installation grant, token request restrictions and returned token scope."
    }
  },
  "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-repository-permission-downscope",
  "machine_readable_record": "/varexis-index/records/github-installation-token-repository-permission-downscope.json"
}
