Dokumentation

CLI/auth

renamed auth

Sichere OAuth-Authentifizierung. Ihre Anmeldedaten gelangen nie in den Shell-Verlauf oder Umgebungsvariablen.

renamed auth <command>

Der auth-Befehl verwaltet die Authentifizierung über OAuth Device Flow. Er öffnet Ihren Browser für die sichere Anmeldung — keine API-Schlüssel zum Kopieren oder Geheimnisse zum Offenlegen.

Tokens werden verschlüsselt in Ihrem System-Schlüsselbund gespeichert (macOS Keychain, Linux libsecret, Windows Credential Manager), nicht in Klartext-Dateien.

Unterbefehle

login

Mit Ihrem renamed.to-Konto über den Browser authentifizieren (OAuth Device Flow).

token

API-Token manuell speichern. Nützlich für CI/CD-Umgebungen.

logout

Gespeicherte Anmeldedaten aus dem Schlüsselbund entfernen.

whoami

Den aktuell authentifizierten Benutzer anzeigen.

status

Authentifizierungsstatus und verbleibende Credits prüfen.

refresh

Abgelaufenes Token manuell aktualisieren.

Beispiele

Anmelden (öffnet Browser):

$ renamed auth login

Browser zur Authentifizierung wird geöffnet...
Warte auf Bestätigung...
✓ Erfolgreich authentifiziert als alex@example.com

Status und verbleibende Credits prüfen:

$ renamed auth status

Angemeldet als: alex@example.com
Token läuft ab: 2026-02-08 14:30:00
Verbleibende Credits: 847

Headless-Anmeldung (kein Browser verfügbar):

$ renamed auth login --no-open

Besuchen Sie diese URL zur Authentifizierung:
https://renamed.to/device?code=ABCD-1234

Token manuell speichern (CI/CD):

$ renamed auth token --token rnt_abc123...

✓ Token erfolgreich gespeichert

Prüfen, als wer Sie angemeldet sind:

$ renamed auth whoami

alex@example.com

Abmelden:

$ renamed auth logout

✓ Erfolgreich abgemeldet

Login-Optionen

--no-open

Browser nicht automatisch öffnen. Gibt eine URL aus, die auf einem anderen Gerät besucht werden kann.

--client-id <id>

Benutzerdefinierte OAuth-Client-ID für Enterprise-SSO.

--client-secret <secret>

Benutzerdefiniertes OAuth-Client-Secret für Enterprise-SSO.

--scope <scopes>

Kommagetrennte Liste der anzufordernden OAuth-Scopes.

Token-Optionen

-t, --token <token>

Das zu speichernde API-Token.

-s, --scheme <scheme>

Autorisierungsschema (Standard: Bearer).

--non-interactive

Keine Eingabeaufforderung. Beendet mit Fehler, wenn Token fehlt.

Token-Speicherung

macOS — Keychain Access

Linux — libsecret (GNOME Keyring, KWallet)

Windows — Credential Manager

Umgebungsvariablen

RENAMED_TOKEN — API-Token für Authentifizierung (Alternative zu auth token)

RENAMED_CLIENT_ID — Benutzerdefinierte OAuth-Client-ID für Enterprise-SSO

RENAMED_CLIENT_SECRET — Benutzerdefiniertes OAuth-Client-Secret für Enterprise-SSO

Tipps

Vor der Installation als Dienst — Führen Sie immer renamed auth login aus, bevor Sie renamed service install ausführen. Der Dienst benötigt zwischengespeicherte Anmeldedaten.

Headless-Server — Verwenden Sie --no-open auf Servern ohne Display. Kopieren Sie die URL und authentifizieren Sie sich von einem beliebigen Gerät mit Browser.

CI/CD-Umgebungen — Verwenden Sie die RENAMED_TOKEN-Umgebungsvariable oder den auth token-Befehl.

Token-Ablauf — Tokens werden automatisch aktualisiert. Bei Authentifizierungsfehlern führen Sie renamed auth refresh aus oder melden Sie sich erneut an.

Siehe auch

service — als systemd-Dienst bereitstellen watch — Ordner auf neue Dateien überwachen