Register Secrets
Via Secret Manager UI
Access from bottom-left menu → “Manage Secrets”:Via OAuth Integration
For supported providers (GitHub, GitLab, Google, Microsoft):Activate Secrets for Session
Use the /secrets Command
Via Natural Language
Use Activated Secrets
In Sandbox Operations
Once activated, secrets are available as environment variables:For Tool Execution
Maestro’s tools automatically use activated secrets:Deactivate Secrets
When done with sensitive operations:Cloud Provider Setup
AWS Configuration
Register these secrets:Azure Configuration
Register:Google Cloud Configuration
Register:Version Control Integration
GitHub (OAuth - Recommended)
Link your GitHub account via Secret Manager:GitHub (Personal Access Token)
Alternatively, register a PAT:GitLab Integration
Similar to GitHub - use OAuth or PAT:Database Connections
PostgreSQL
Register connection URL:MySQL
Similar pattern:MongoDB
API Services
OpenAI or Anthropic APIs
For using AI APIs in your code:Stripe Integration
Email Services (SendGrid, Mailgun)
OAuth vs Personal Access Tokens
When to Use OAuth
Advantages:- Automatic token refresh (no manual intervention)
- Granular scope control
- Revocable via provider UI
- Better security
When to Use Personal Access Tokens
Advantages:- Simple setup (just copy/paste)
- Works in automation scenarios
- No browser required
Security Best Practices
Scope Minimization
Grant only necessary permissions:Environment Separation
Use separate secrets per environment:Secret Rotation
Rotate secrets regularly:Troubleshoot Issues
Secret Not Working
Check these steps:Permission Denied
For cloud services:OAuth Token Expired
If automatic refresh fails:Secret Accidentally Committed
If you accidentally put a secret in a file:Integration Workflows
AWS Deployment Example
Database Migration Example
Third-Party API Integration
Multiple Account Patterns
Multiple GitHub Accounts
Multiple AWS Accounts
Next Steps
Master secret management, then explore:- How to Use the Sandbox: Leverage secrets in sandbox operations
- How to Work with Source Control: GitHub integration workflows
- How to Troubleshoot Common Issues: Debug integration problems
- Reference: Supported Integrations: Complete credential reference

