Skip to content

Current Expected Variables and Secrets - codex Repository

Last Updated: 2026-07-11 Version: v0.2.0

SUPERSEDED — This document is preserved for historical reference only. The current unified reference is: docs/admin/GITHUB_VARIABLES_MASTER_GUIDE.md

Generated: 2026-06-22 Status: Verified Against Codebase Purpose: Reference document for all secrets and variables


Complete Inventory

Repository Secrets (10 total)

Secret Name Usage Referenced In Status
CODEX_GHP_TOKEN_BASE64 Base64-encoded GitHub token copilot-with-mcp.yml, token-rotation.yml Active
CODEX_GHP_TOKEN_CONFIG Combined AES config (JSON) copilot-with-mcp.yml, token-rotation.yml Active
CODEX_MASTER_KEY Master encryption key (Reserved for future use) Planned
ENABLE_LIVE_TESTS Enable live API tests integration-gated.yml Active
GH_TOKEN GitHub token (alias) Multiple workflows Active
GITHUB_CODEX OpenAI API key agent-runtime.yml Active
GITHUB_TOKEN Default GitHub Actions token Auto-provided by Actions Active
GITLEAKS_LICENSE Gitleaks license key for Pro/Enterprise security-suite.yml Optional
OPENAI_API_KEY OpenAI API key integration-gated.yml Active
PINECONE_API_KEY Pinecone vector DB key integration-gated.yml Active

Repository Variables (11 total)

Variable Name Usage Referenced In Status
CODEX_AGENT_NAME Agent identifier copilot-with-mcp.yml Active
CODEX_API_VERSION API version string copilot-with-mcp.yml Active
CODEX_LOG_LEVEL Logging verbosity copilot-with-mcp.yml Active
CODEX_ORG_NAME Organization name copilot-with-mcp.yml Active
CODEX_REPO_ID Repository identifier copilot-with-mcp.yml Active
CODEX_SECURITY_ADMIN_GUIDE_B64 Base64 admin guide security-tools-bootstrap.yml Active
CODEX_SECURITY_DECODER_MODULE_B64 Base64 decoder module security-tools-bootstrap.yml Active
CODEX_SECURITY_ENCRYPTION_TOOL_B64 Base64 encryption tool security-tools-bootstrap.yml Active
CODEX_SECURITY_MANIFEST_JSON Security manifest security-tools-bootstrap.yml Active
GENESIS_TIMESTAMP Repository creation time (Metadata) Active
RUNS_ON Default runner label (Workflow configuration) Active

Common Environment Variables (50+ total)

Only listing security-relevant environment variables:

Variable Context Usage
GITHUB_TOKEN Workflow Auto-provided by Actions
GITHUB_SHA Workflow Current commit SHA
GITHUB_REF_NAME Workflow Branch or tag name
GITHUB_WORKSPACE Workflow Workspace directory
GITHUB_ACTOR Workflow User triggering workflow
GITHUB_ENV Workflow Path to env file
GITHUB_OUTPUT Workflow Path to output file
GITHUB_STEP_SUMMARY Workflow Path to summary file

Token Encryption Tool Variables

Generated by scripts/security/token_encryption_tool.py

These secrets should be created by running the encryption tool:

# Primary secrets (choose one method)
CODEX_GHP_TOKEN_BASE64       #  Recommended: Simple encoding
CODEX_GHP_TOKEN_HEX          # Alternative: Hex encoding
CODEX_GHP_TOKEN_CONFIG       #  Recommended: Combined AES config

# AES-256-GCM components (if not using combined config)
CODEX_GHP_TOKEN_AES_KEY
CODEX_GHP_TOKEN_AES_CIPHERTEXT
CODEX_GHP_TOKEN_AES_NONCE
CODEX_GHP_TOKEN_AES_TAG
CODEX_GHP_TOKEN_AES_AUTH_DATA

# Verification
CODEX_GHP_TOKEN_SHA256       # One-way hash for validation

Decoder Module Priority Order

From scripts/security/copilot_token_decoder.py:

  1. CODEX_GHP_TOKEN_CONFIG (Combined AES - most secure)
  2. CODEX_GHP_TOKEN_AES_CIPHERTEXT + CODEX_GHP_TOKEN_AES_KEY (Separated AES)
  3. CODEX_GHP_TOKEN_BASE64 (Simple encoding - recommended for simplicity)
  4. CODEX_GHP_TOKEN_HEX (Alternative encoding)
  5. GITHUB_TOKEN or GH_TOKEN (Fallback - plaintext)

Usage by Workflow

High-Priority Workflows

.github/workflows/copilot-with-mcp.yml:

secrets:
  - CODEX_GHP_TOKEN_BASE64
  - CODEX_GHP_TOKEN_CONFIG
variables:
  - CODEX_AGENT_NAME
  - CODEX_API_VERSION
  - CODEX_LOG_LEVEL
  - CODEX_ORG_NAME
  - CODEX_REPO_ID

.github/workflows/agent-runtime.yml:

secrets:
  - GITHUB_CODEX (OpenAI API key)
  - GITHUB_TOKEN (auto-provided)

.github/workflows/integration-gated.yml:

secrets:
  - PINECONE_API_KEY
  - OPENAI_API_KEY
  - ENABLE_LIVE_TESTS

.github/workflows/security-tools-bootstrap.yml:

variables:
  - CODEX_SECURITY_ENCRYPTION_TOOL_B64
  - CODEX_SECURITY_DECODER_MODULE_B64
  - CODEX_SECURITY_ADMIN_GUIDE_B64
  - CODEX_SECURITY_MANIFEST_JSON

.github/workflows/token-rotation.yml:

secrets:
  - CODEX_GHP_TOKEN_BASE64
  - CODEX_GHP_TOKEN_CONFIG


Scan Results

Extracted from Codebase (2026-01-01)

Secrets Found: 10 unique references Variables Found: 11 unique references Environment Variables: 50+ unique references

Files Scanned: - .github/workflows/*.yml (30+ workflow files) - scripts/**/*.py (Security and automation scripts) - src/**/*.py (Source code)


Verification Checklist

Use this checklist to verify your secrets/variables configuration:

Required for Copilot Operations

  • CODEX_GHP_TOKEN_BASE64 or CODEX_GHP_TOKEN_CONFIG set
  • GITHUB_TOKEN available (auto-provided)
  • CODEX_AGENT_NAME variable defined
  • Token encryption tool tested: python3 scripts/security/token_encryption_tool.py --help
  • Token decoder tested: python3 -c "from scripts.security.copilot_token_decoder import CodexTokenDecoder"

Required for AI/ML Features

  • GITHUB_CODEX (OpenAI API key) set
  • OPENAI_API_KEY set (if using direct OpenAI)
  • PINECONE_API_KEY set (if using vector storage)
  • ENABLE_LIVE_TESTS set (for integration tests)

Required for Security Tools Bootstrap

  • CODEX_SECURITY_ENCRYPTION_TOOL_B64 variable set
  • CODEX_SECURITY_DECODER_MODULE_B64 variable set
  • CODEX_SECURITY_ADMIN_GUIDE_B64 variable set
  • CODEX_SECURITY_MANIFEST_JSON variable set

Optional/Advanced

  • CODEX_MASTER_KEY (for future encryption features)
  • GITLEAKS_LICENSE (if using Gitleaks Pro)
  • Organization-level secrets configured
  • Environment-specific secrets (dev/staging/prod)

Important Notes

Security Considerations

  1. Never Commit Secrets: All secrets listed above should ONLY be stored in GitHub Settings Secrets
  2. Token Rotation: Rotate CODEX_GHP_TOKEN_* secrets every 90 iterations
  3. API Key Rotation: Rotate OPENAI_API_KEY and PINECONE_API_KEY quarterly
  4. Access Control: Limit repository admin access to trusted users only
  5. Audit Logs: Regularly review secret access logs in repository settings

Variable Naming Conventions

  • Secrets: CODEX_*, GITHUB_*, OPENAI_*, etc.
  • Variables: CODEX_* prefix for codex-specific variables
  • Environment: GITHUB_* for Actions-provided variables

Compatibility

All variables listed are compatible with: - GitHub Actions workflows - token_encryption_tool.py (v2.0) - copilot_token_decoder.py (v2.0) - security-tools-bootstrap.yml workflow - All agent workflows in .github/workflows/



Update History

Date Changes Author
2026-01-01 Initial comprehensive inventory @copilot
2025-12-29 Added security tool variables @mbaetiong
2025-12-23 Added integration test secrets Security Team

Maintained By: Security Team & @copilot Last Verified: 2026-01-01 Next Review: 2026-04-01 (Quarterly)