mirror of
https://github.com/hanzoskill/oura-analytics.git
synced 2026-10-30 21:10:57 +00:00
3.4 KiB
3.4 KiB
Security & Privacy
Data Storage
Local Storage Only:
- All Oura data is stored locally in
~/.oura-analytics/cache/ - No data is sent to third-party services
- Cache files are stored as JSON:
cache/{endpoint}/{date}.json
What's Cached:
- Sleep, readiness, and activity data per day
- Sync state tracking (last sync timestamps)
- No personally identifiable information beyond what Oura provides
Cache Location:
~/.oura-analytics/
├── cache/
│ ├── sleep/2026-01-20.json
│ ├── daily_readiness/2026-01-20.json
│ └── daily_activity/2026-01-20.json
└── sync_state.json
API Token Security
Token Storage:
- Your Oura API token must be set via environment variable:
OURA_API_TOKEN - NEVER commit tokens to git
- NEVER log tokens or include them in output
- Store in
~/.bashrc,~/.zshrc, or secure credential manager
Get Your Token:
- Visit: https://cloud.ouraring.com/personal-access-token
- Generate a Personal Access Token
- Set environment variable:
export OURA_API_TOKEN="your_token_here"
Token Rotation: To rotate your token:
- Generate new token at https://cloud.ouraring.com/personal-access-token
- Update
OURA_API_TOKENenvironment variable - Restart any running scripts/cron jobs
- Revoke old token in Oura Cloud dashboard
Token Permissions:
- Read-only access to your Oura data
- No write or delete permissions
- Token can be revoked at any time from Oura Cloud
What's Never Logged
The skill NEVER logs:
- Your Oura API token
- Raw API responses (unless explicitly debugging)
- Personally identifiable information
- Location data or GPS coordinates
Safe to Log:
- Aggregated metrics (sleep scores, averages)
- Date ranges and timestamps
- Cache hit/miss statistics
- Error messages (sanitized)
Data Retention
Cache Retention:
- Cached data persists indefinitely until manually cleared
- Clear cache:
python scripts/oura_api.py cache --clear - Clear specific endpoint:
python scripts/oura_api.py cache --clear --endpoint sleep
No Automatic Deletion:
- Cache files are never automatically deleted
- You control when and what data is removed
Privacy Best Practices
For Bot Integration:
- Store
OURA_API_TOKENin~/.bot/.env(git-ignored) - Use
--format briefor--format alertto minimize data in logs - Use
--format silentfor cron jobs (exit code only, no output) - Never share cache files publicly (contains your health data)
For Manual Use:
- Set token in shell profile (
~/.bashrcor~/.zshrc) - Use
--no-cacheflag for sensitive queries (no local storage) - Clear cache periodically if concerned about disk usage
- Review cache files before sharing terminal output
Reporting Security Issues
If you discover a security vulnerability:
- DO NOT open a public GitHub issue
- Email: [email protected] with "Oura Analytics Security" subject
- Include:
- Description of the vulnerability
- Steps to reproduce
- Potential impact
- Suggested fix (if available)
Compliance
GDPR Compliance:
- You own your data (local storage only)
- You control data retention (manual cache clearing)
- No data sharing with third parties
- Right to deletion (clear cache anytime)
HIPAA Note:
- This skill is NOT HIPAA-compliant
- Do not use for medical decision-making
- Consult healthcare professionals for health concerns