WebCull - Documentation - Authentifizierung

Authentifizierung

Die CLI Mit Einem Browser-Freigabefluss Autorisieren

Die CLI verwendet einen kurzlebigen Browser-Genehmigungsablauf. Genehmigen Sie nur Anfragen, die Sie mit webcull login gestartet haben; die Genehmigung erstellt ein separates, eingeschränktes CLI-Token.

Separate access

Die CLI-Autorisierung ist von der Anmeldung im Browser und in der Erweiterung getrennt. Jedes Kontotoken wird in einem eigenen Anmeldeinformationseintrag des Betriebssystems gespeichert, während die Konfigurationsdatei nur nicht geheime Kontodetails enthält.

Befehl

Login Starten Und Das Konto Pruefen

webcull login
webcull accounts
webcull whoami --account <account-hash>

webcull login

Startet die Autorisierung und öffnet die Bestätigungsseite im Browser.

webcull auth login

Alias für webcull login.

webcull accounts

Listet jedes lokal autorisierte Konto mit Benutzer-ID, Hash, Ablaufdatum und aktivem Status auf, ohne Token auszugeben.

webcull whoami --account <account-hash>

Zeigt das autorisierte Konto und den Ablaufzeitpunkt des Tokens an.

Mehrere Konten

Mehrere Konten gleichzeitig angemeldet lassen

Jede erfolgreiche Anmeldung fügt eine weitere lokale CLI-Autorisierung hinzu. Verwenden Sie --account <hash|id>, um ein Konto für einen Befehl auszuwählen. Ohne diese Option verwenden gewöhnliche Befehle das zuletzt erfolgreich aufgerufene Konto.

webcull accounts
webcull bookmarks count --account abc123 --path /
webcull bookmarks search --account abc123 --query 'project notes' --limit 20

{
  "success": "true",
  "active_account": "abc123",
  "accounts": [
    {
      "number": 1,
      "active": true,
      "user": {
        "id": 42,
        "hash": "abc123",
        "name": "Personal",
        "email": "person@example.com"
      }
    }
  ]
}

Agent selection

Agenten sollten zu Beginn eines neuen WebCull-Kontexts webcull accounts ausführen. Bei einem Konto verwenden sie dessen Hash automatisch. Bei mehreren Konten zeigen sie eine nummerierte Liste, fragen nach dem passenden Konto und fügen dessen Hash jedem späteren Befehl hinzu.

Abmelden

Konto vor dem Widerruf des Zugriffs auswählen

webcull logout
webcull logout --account abc123
webcull logout --account abc123 --local-only

Wenn mehrere Konten angemeldet sind, zeigt der interaktive Befehl webcull logout eine nummerierte Auswahl. Nicht interaktive Aufrufer erhalten eine Kontoauswahlantwort und müssen den Befehl mit dem vorgesehenen Hash oder der Benutzer-ID erneut ausführen.

Die normale Abmeldung widerruft das ausgewählte Servertoken, bevor die lokale Anmeldeinformation entfernt wird. Eine rein lokale Abmeldung entfernt die ausgewählte lokale Anmeldeinformation und warnt, dass das Servertoken weiterhin gültig sein kann.

Ausgabe

Die Kontoantwort Lesen

{
  "success": "true",
  "user": {
    "id": 42,
    "hash": "abc123abc123abc123abc123abc123",
    "email": "person@example.com"
  },
  "scopes": ["bookmarks:read", "bookmarks:write"],
  "expires": 1781300000
}

Verwenden Sie scopes, um die Berechtigungen dieses Tokens zu bestätigen. Lesebefehle erfordern bookmarks:read. Erstellen, Aktualisieren sowie das Erstellen und Stornieren von Erinnerungen erfordern bookmarks:write.