Organisationen

Eine Organisation fasst Zugangsdaten unter einem Eigentümer zusammen, sodass mehrere Personen sie teilen können: API-Schlüssel für die JSON-API und Proxy-Benutzer für den Proxy-Port. Alle Verbräuche der Zugangsdaten einer Organisation werden auf den Plan des Organisationseigentümers angerechnet, nicht auf die Person, die den Request gesendet hat.

Wo du es findest

Melde dich im Dashboard an und öffne Organizations in der Seitenleiste. Jede Organisation, zu der du gehörst, ist eine Zeile:

Spalte	Was angezeigt wird
Organisation	Der Name. Klicke darauf oder auf Open, um zur Seite der Organisation zu gelangen.
Deine Rolle	Owner, Admin oder Member
Mitglieder	Wie viele Personen darin sind, einschließlich des Eigentümers
Schlüssel	Wie viele API-Schlüssel die Organisation besitzt
Erstellt	Wann sie erstellt wurde
Aktionen	Open

Eine Organisation erstellen

Klicke auf New organization, gib einen Namen zwischen 2 und 60 Zeichen ein und bestätige. Du wirst zum Eigentümer. Der Name muss mindestens einen Buchstaben oder eine Ziffer enthalten und darf nicht mit dem Namen einer bestehenden Organisation übereinstimmen (Buchstaben und Ziffern werden verglichen, alles andere wird ignoriert).

Das Erstellen einer Organisation erfordert einen Plan, der mehr als eine Person abdeckt. Die Zeile Organizations you own unter Usage & Limits zeigt, ob dein Plan dies unterstützt.

Rollen

Es gibt drei Rollen, und jede Organisation hat genau einen Eigentümer.

Rolle	Was erlaubt ist
Member	API-Schlüssel und Proxy-Benutzer der Organisation erstellen und verwenden, ihre API-Schlüssel umbenennen und die Mitglieder und Teams der Organisation sehen
Admin	Alles, was ein Member kann, plus Personen hinzufügen und entfernen, deren Rollen ändern, alle Zugangsdaten der Organisation verwalten und die Organisation umbenennen
Owner	Alles, was ein Admin kann, plus die Organisation an eine andere Person übergeben. Der Eigentümer hält den Plan, über den alle Zugangsdaten der Organisation abgerechnet werden.

Der Eigentümer kann nicht entfernt werden, die Organisation nicht verlassen und nicht herabgestuft werden. Die Eigentümerschaft wechselt nur in eine Richtung: durch Übertragung.

Die Mitgliedschaft in der Organisation gewährt Zugriff auf deren Zugangsdaten. Ein Mitglied ohne Administratorrechte kann trotzdem einen Schlüssel oder einen Proxy-Benutzer erstellen, den das Unternehmen bezahlt. Genau das ist der Zweck: Ein Entwickler, der Scraper schreibt, sollte keine persönlichen Zugangsdaten benötigen, die stillschweigend ihm statt dem Unternehmen in Rechnung gestellt werden.

Die Organisationsseite

Open in einer Zeile führt dich zur Seite dieser Organisation. Sechs Karten befinden sich oben: Mitglieder (mit der Aufteilung nach Owner, Admin und Member darunter), Deine Rolle, Owner, API-Schlüssel, Proxy-Benutzer und Teams. Darunter zwei Tabs:

Members: die Personen in der Organisation sowie die Optionen deiner Rolle.
Teams: die Teams innerhalb dieser Organisation, zu denen du gehörst (schreibgeschützt).

Eigentümer und Administratoren erhalten außerdem eine Schaltfläche Rename in der Kopfzeile der Seite.

Personen hinzufügen

Eigentümer und Administratoren sehen eine Karte Add a member über der Mitgliedertabelle. Gib eine E-Mail-Adresse ein, wähle Member oder Admin und bestätige.

Was als Nächstes passiert, hängt von der Adresse ab, und das Dashboard zeigt dir, welcher Fall zutrifft:

Die Adresse hat bereits einen FourA Account: Die Person tritt sofort bei und erhält eine E-Mail mit dem Namen der Organisation, wer sie hinzugefügt hat und welche Rechte ihre Rolle beinhaltet.
Die Adresse hat keinen Account: FourA sendet ihr eine Einladung per E-Mail, und sie tritt in dem Moment bei, in dem sie sich mit dieser Adresse anmeldet. Es muss nichts geklickt werden, und die Einladung funktioniert unabhängig davon, ob sie sich neu registriert oder bereits einen zuvor ungenutzten Account hatte.

Einladungen laufen nach 14 Tagen ab. Wenn du dieselbe Adresse erneut hinzufügst, wird die ausstehende Einladung aktualisiert, anstatt eine zweite zu stapeln.

Der Owner erhält eine E-Mail, sobald jemand beitritt, da die neue Person das Guthaben des Owners verbraucht. Niemand erhält eine E-Mail als Bestätigung der eigenen Aktion.

Ausstehende Einladungen

Solange mindestens eine Einladung offen ist, wird oberhalb von Members eine Tabelle Invitations angezeigt, die für Owner und Admins sichtbar ist. Sie listet die Adresse, die vorgesehene Rolle, die einladende Person und den Zeitpunkt auf. Abgelaufene Einladungen bleiben aufgeführt und werden entsprechend markiert, damit du siehst, warum niemand beigetreten ist. Nutze die Aktion in der Zeile, um eine Einladung zurückzuziehen.

Rolle ändern

Owner und Admins wechseln die Rolle eines Mitglieds zwischen Member und Admin über das Dropdown-Menü in der Spalte Role. Drei Regeln:

Du kannst deine eigene Rolle nicht ändern. Bitte einen anderen Admin darum oder verlasse die Organisation.
Die Rolle des Owners kann hier nicht bearbeitet werden. Nutze stattdessen Make owner.
Jede Änderung erfordert eine Bestätigung und zeigt an, welche Rechte die Person anschließend hat.

Jemanden entfernen und die Organisation verlassen

Owner und Admins sehen Remove in jeder Zeile außer der eigenen und der des Owners. Deine eigene Zeile enthält stattdessen Leave, unabhängig von deiner Rolle.

Wenn du jemanden entfernst, wird die Person auch aus den Teams der Organisation entfernt, sodass sie die zugehörigen Credentials sofort nicht mehr sieht. Die Credentials selbst bleiben unberührt: Ein Key oder ein Proxy-User einer Organisation gehört der Organisation, nicht der Person, die ihn erstellt hat.

Der Owner kann weder entfernt werden noch die Organisation verlassen. Übertrage zuerst die Organisation.

Organisation übertragen

Nur der Owner kann dies tun. Klicke im Tab Members bei der Person, die übernehmen soll, auf Make owner und bestätige die Aktion.

Die Organisation wechselt in deren Tarif: Ab diesem Moment zählt jeder Request ihrer Keys und jeder Tunnel ihrer Proxy-User für deren Guthaben, deren Traffic, deren Limits und deren Rechnung. Der bisherige Owner wird zum Admin und behält alle Rechte eines Admins.

Welche Keys du siehst

Jeder Key, der einer Organisation gehört, ist für alle Mitglieder der Organisation sichtbar. Der Unterschied liegt darin, was du damit tun darfst:

Aktion	Member	Admin	Owner
Key nutzen, aufdecken, neue Organisations-Keys erstellen	Ja	Ja	Ja
Umbenennen, Beschreibung bearbeiten	Ja	Ja	Ja
Neu generieren, deaktivieren, löschen	Nein	Ja	Ja
Key aus der Organisation verschieben	Nein	Nein	Ja

Das Umbenennen eines Keys ist harmlos. Das Neugenerieren oder Deaktivieren blockiert sofort alle Kollegen, die ihn nutzen. Deshalb liegt dies bei Admins. Das Herausverschieben eines Keys entfernt das Asset aus dem Unternehmen und überträgt die Nutzung auf den eigenen Plan des Empfängers. Daher bleibt dies allein dem Owner vorbehalten.

Siehe Managing API Keys für die vollständige Anleitung.

Welche Proxy-User du siehst

Für einen Proxy-User gelten aus denselben Gründen die gleichen drei Ebenen.

Action	Member	Admin	Owner
Nutzen, Passwort lesen, neue erstellen	Ja	Ja	Ja
Neues Passwort, deaktivieren, löschen, gespeichertes Targeting ändern	Nein	Ja	Ja
Aus der Organisation übertragen	Nein	Nein	Ja

Gespeichertes Targeting liegt bei Admins statt bei Members, da eine Neuausrichtung stillschweigend jede Verbindung umleitet, die die gesamte Organisation mit diesen Zugangsdaten herstellt. Ein neues Passwort liegt dort, weil es jede Konfigurationsdatei bricht, in die die Zugangsdaten bereits eingefügt wurden.

Der Downloader eines Unternehmens gehört auf den Proxy-User einer Organisation. Ein persönlicher funktioniert ab dem Tag nicht mehr, an dem die Person geht, und wird ihr in Rechnung gestellt. Siehe Proxy Users für die Anleitung.

Der Owner-Filter

Sobald du zu einer Organisation gehörst, erscheint ein Owner-Dropdown über Overview, Metrics, Activity, API Keys und Proxy. Es bietet drei Arten von Optionen: Everything, Personal und einen Eintrag pro Organisation. Die Auswahl bleibt zwischen Besuchen gespeichert und gilt für alle diese fünf Seiten.

Usage & Limits und Billing unterstützen den Filter bewusst nicht. Sie beantworten die Frage "Was wird mir in Rechnung gestellt", was sich von "Was kann ich sehen" unterscheidet: Ein Member sieht niemals das Kontingent des Owners.

Abrechnungszuordnung

Jeder Request mit einem Key der Organisation und jeder mit einem Proxy-User der Organisation geöffnete Tunnel wird dem Owner der Organisation in Rechnung gestellt, egal wer ihn ausgelöst hat. Das ist der eigentliche Grund, Zugangsdaten in eine Organisation zu verschieben: Es ändert, wem die Nutzung für Credits, Traffic, Plan-Limits und Rechnungen angerechnet wird.

Die Seite Usage & Limits des Owners zählt Organisations-Zugangsdaten neben den persönlichen auf dem Tab "API keys" und dem Tab "Proxy users" und trennt beide, damit klar ist, woher die Ausgaben stammen.

Teams

Jede Organisation erhält ein Standard-Team namens Everyone. Neue Keys werden ihm automatisch zugeordnet und jeder, der der Organisation beitritt, wird hinzugefügt. Dadurch gewährt die Mitgliedschaft Zugriff auf die Keys.

Der Tab "Teams" listet die Teams auf, zu denen du gehörst, zusammen mit deiner Rolle in jedem, der Mitgliederanzahl und den Keys, die du verwenden kannst (Keys you can use). Das Erstellen und Bearbeiten von Teams ist im Dashboard noch nicht verfügbar.