Tutorials

GitHub Secrets hinzufügen: Der ultimative Guide [2025 – Einfach & Schnell]

Melden

Hier ist ein aktuelles, leicht verständliches Tutorial für das Jahr 2025, wie du GitHub Secrets sicher zu deinem Repository hinzufügst.

GitHub Secrets sind essenziell, um sensible Daten wie API-Schlüssel, Passwörter oder Token sicher in deinen Projekten zu speichern. Sie werden verschlüsselt und können in GitHub Actions verwendet werden, ohne dass sie im Quellcode sichtbar sind.

1. Was du vorab wissen solltest

  • Verschlüsselung: Secrets werden von GitHub verschlüsselt gespeichert.
  • Sichtbarkeit: Einmal gespeichert, kannst du den Wert eines Secrets nie wieder ansehen (nur aktualisieren oder löschen).
  • Benennung: Nutze Großbuchstaben und Unterstriche (z. B. API_KEY_PRODUCTION).

2. Schritt-für-Schritt-Anleitung

Schritt 1: Navigiere zu deinem Repository

Öffne GitHub in deinem Browser und gehe zu dem Projekt (Repository), in dem du das Secret hinzufügen möchtest.

Schritt 2: Einstellungen (Settings) öffnen

Klicke in der oberen Menüleiste deines Repositories auf den Reiter „Settings“ (ganz rechts, meistens hinter dem Zahnrad-Icon).

Schritt 3: Secrets und Variablen finden

Suche in der linken Seitenleiste den Abschnitt „Security“.

  1. Klicke auf den Menüpunkt „Secrets and variables“.
  2. Es öffnet sich ein Untermenü – klicke dort auf „Actions“.

Schritt 4: Ein neues Secret erstellen

Du siehst nun den Bereich „Repository secrets“.

  1. Klicke auf den grünen Button „New repository secret“.

Schritt 5: Name und Wert eingeben

  • Name: Gib deinem Secret einen aussagekräftigen Namen (z. B. MY_DATABASE_PASSWORD).
  • Secret: Füge hier den eigentlichen geheimen Wert (den Key oder das Passwort) ein.
  • Klicke abschließend auf den Button „Add secret“.

3. Wie du das Secret in GitHub Actions verwendest

Sobald das Secret gespeichert ist, kannst du es in deiner .yml-Workflow-Datei aufrufen. GitHub stellt dafür das secrets-Objekt bereit.

Beispiel für eine Workflow-Datei:

name: Mein CI Workflow

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Nutze den API Key
        env:
          MY_API_KEY: ${{ secrets.MY_API_KEY_PRODUCTION }} # Hier wird das Secret aufgerufen
        run: |
          echo "Das Secret wird sicher im Hintergrund verwendet..."
          # Nutze $MY_API_KEY in deinem Skript

4. Profi-Tipps für 2025

Unterschied zwischen Repository und Environment Secrets

  • Repository Secrets: Gelten für das gesamte Projekt.
  • Environment Secrets: (Empfohlen für Profis) Gelten nur für bestimmte Umgebungen (z. B. "Production" oder "Staging"). Diese findest du ebenfalls unter Settings -> Environments.

Sicherheits-Check

  • Kein Logging: GitHub filtert Secrets automatisch aus den Log-Dateien deiner Actions heraus (sie erscheinen dort als ***). Versuche dennoch niemals, Secrets absichtlich mit echo auszugeben.
  • Geringste Berechtigung: Gib deinen Secrets nur so viel Zugriff wie nötig.

Zusammenfassung

  1. Settings -> Secrets and variables -> Actions.
  2. New repository secret klicken.
  3. Name und Wert eingeben.
  4. Per ${{ secrets.DEIN_NAME }} im Code nutzen.

Glückwunsch! Dein Projekt ist nun sicherer und bereit für automatisierte Workflows.

0