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:
CODEX_GHP_TOKEN_CONFIG(Combined AES - most secure)CODEX_GHP_TOKEN_AES_CIPHERTEXT+CODEX_GHP_TOKEN_AES_KEY(Separated AES)CODEX_GHP_TOKEN_BASE64(Simple encoding - recommended for simplicity)CODEX_GHP_TOKEN_HEX(Alternative encoding)GITHUB_TOKENorGH_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:
.github/workflows/integration-gated.yml:
.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:
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_BASE64orCODEX_GHP_TOKEN_CONFIGset -
GITHUB_TOKENavailable (auto-provided) -
CODEX_AGENT_NAMEvariable 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_KEYset (if using direct OpenAI) -
PINECONE_API_KEYset (if using vector storage) -
ENABLE_LIVE_TESTSset (for integration tests)
Required for Security Tools Bootstrap¶
-
CODEX_SECURITY_ENCRYPTION_TOOL_B64variable set -
CODEX_SECURITY_DECODER_MODULE_B64variable set -
CODEX_SECURITY_ADMIN_GUIDE_B64variable set -
CODEX_SECURITY_MANIFEST_JSONvariable 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¶
- Never Commit Secrets: All secrets listed above should ONLY be stored in GitHub Settings Secrets
- Token Rotation: Rotate
CODEX_GHP_TOKEN_*secrets every 90 iterations - API Key Rotation: Rotate
OPENAI_API_KEYandPINECONE_API_KEYquarterly - Access Control: Limit repository admin access to trusted users only
- 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/
Related Documentation¶
- Token Setup:
docs/admin/security/ADMIN_TOKEN_SETUP.md - Encryption Tool:
scripts/security/token_encryption_tool.py - Decoder Module:
scripts/security/copilot_token_decoder.py - Security Policy:
SECURITY.md - Secrets Configuration:
.github/agents/SECRETS_CONFIGURATION.md - Token Review:
docs/security/token_encryption_tool_review_2026-01-01.md
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)