Personal Access Tokens

Personal Access Tokens (PATs) ermöglichen den programmatischen Zugriff auf die TeamDay API für Automatisierung, CI/CD Pipelines und Agent-Authentifizierung.

Schnelleinstieg

1. Token erstellen

  1. Navigieren Sie zu Einstellungen → Profil
  2. Scrollen Sie zu Personal Access Tokens
  3. Klicken Sie auf Token erstellen
  4. Geben Sie einen aussagekräftigen Namen ein (z.B. "CI Pipeline", "Production Automation")
  5. Wählen Sie eine Ablaufperiode aus (90 Tage empfohlen)
  6. Kopieren Sie das Token sofort - es wird nur einmal angezeigt!

2. Token verwenden

Includieren Sie Ihr Token im Authorization Header:

curl -H "Authorization: Bearer td_your-token-here" \
     https://teamday.ai/api/v1/agents

Oder legen Sie es als Umgebungsvariable fest:

export TEAMDAY_TOKEN="td_your-token-here"

curl -H "Authorization: Bearer $TEAMDAY_TOKEN" \
     https://teamday.ai/api/v1/agents

Security Best Practices

⚠️ Wichtige Sicherheitsrichtlinien:

  • Commiten Sie Tokens niemals in Versionskontrolle - Verwenden Sie Umgebungsvariablen oder Secret Manager
  • Rotieren Sie Tokens regelmäßig - Legen Sie angemessene Ablaufdaten fest
  • Verwenden Sie separate Tokens pro Integration - Macht Widerruf einfacher
  • Benennen Sie Tokens beschreibend - Wissen Sie, wo jedes Token verwendet wird
  • Widerrufen Sie ungenutzte Tokens sofort - Reduzieren Sie die Sicherheitsfläche
  • Teilen Sie Tokens nie - Jedes Team-Mitglied sollte sein eigenes haben

Vollständige Dokumentation folgt...