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.

Wo Ihr Zugriffstoken gespeichert wird

Die CLI-Anmeldung ist von der Anmeldung im Browser und in der Erweiterung getrennt. Jedes verbundene Konto erhält ein eigenes Zugriffstoken, das Ihr Computer in einem geschützten Passwortspeicher aufbewahrt. Die CLI-Einstellungsdatei listet Ihre verbundenen Konten auf, enthält aber niemals deren Token.

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. Verwenden Sie --local-only nur, wenn WebCull nicht erreichbar ist und Sie den Zugriff trotzdem von diesem Gerät entfernen müssen. Der Befehl entfernt die ausgewählte lokale Anmeldeinformation, ohne das Servertoken zu widerrufen. Dieses kann bis zu seinem Ablauf weiter verwendet werden.

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.