Skip to content

Bitwarden ​

Zählt Seats je Bitwarden-Organisation über die Bitwarden-Public-API.

Einrichtung ​

  1. In der Bitwarden-Admin-Konsole je Kunden-Organisation den API-Key (client_id + client_secret) erzeugen.
  2. In der Bitwarden-Ansicht über das Zahnrad je Organisation einen Eintrag anlegen: Kundenname + API-Key.

Die Keys sind write-only gespeichert — nach dem Anlegen nicht mehr einsehbar, nur ersetz- oder löschbar.

Metriken ​

MetrikZählung
seatsbelegte Seats der Organisation

Eine Organisation auf mehrere Kunden aufteilen ​

Manche Kunden teilen sich eine Bitwarden-Organisation mit ihren Schwesterunternehmen; die Mitglieder unterscheiden sich nur über die Domain ihrer E-Mail-Adresse. Multiverse kann so eine Organisation nach Domain aufteilen. Ein zusätzlicher Zugang ist nicht nötig — der hinterlegte API-Key listet die Mitglieder der Organisation bereits:

  1. Klicke in Multiverse → Bitwarden → API-Keys in der Zeile des Keys auf Aufteilen…. Der Dialog liest die Mitglieder mit dem Key und zeigt, wie viele einen Seat belegen (eingeladene, angenommene und bestätigte Mitglieder tun das; widerrufene und vorgemerkte bleiben außen vor), wie viele eine E-Mail-Adresse tragen, und die Mitglieder je E-Mail-Domain. Neu lesen liest sie erneut.
  2. Lege je Domain, die zu einem anderen Kunden gehört, eine Domain-Regel an (Zuweisen… in der Domain-Tabelle füllt sie vor): Domain → Kunde. Domains ohne Regel und Mitglieder ohne E-Mail-Adresse bleiben beim Kunden des Keys. Mehrere Domains dürfen auf denselben Kunden zeigen (sie bilden einen Teil); eine Regel auf den Kunden des Keys selbst ist dasselbe wie keine Regel.

Ab dem nächsten Snapshot erscheinen die Seats des Keys unter mehreren Kunden: der Kunde des Keys plus einer je Regel-Kunde. Bitwarden meldet die Seats je Organisation, nicht je Mitglied, deshalb werden sie im Verhältnis der Mitgliederzahlen je Domain aufgeteilt, gerundet auf ganze Seats nach dem größten Rest; die Teile ergeben zusammen immer die Seats der Organisation. Der Dialog zeigt diese Aufteilung unter Nächster Snapshot. Ein Kunde, der zusätzlich einen eigenen Key hat oder Seats aus mehreren aufgeteilten Keys erhält, zeigt eine Zeile mit der Summe — der Kundenname ist bei Bitwarden die Identität.

Eine fehlschlagende Mitgliederliste (typisch: der Self-hosted-Server ist nicht erreichbar) lässt nicht mehr jeden Seat beim Kunden des Keys: Der Snapshot verteilt die heutigen Seats nach den Mitgliedern des letzten erfolgreichen Abrufs, die Kunden der Regeln behalten ihren Anteil (nur ein Key, dessen Mitglieder noch nie gelesen wurden, bleibt ganz); der Snapshot trägt einen Hinweis mit dem Tag dieses Abrufs, den die Rechnungsläufe wiederholen. Ein Key, der ganz fehlschlägt, lässt in diesem Snapshot jeden Kunden aus, den er speist (seinen eigenen und die seiner Regeln), damit kein Kunde eine Teilsumme zeigt — diese Kunden werden als nicht gelesen festgehalten und behalten die Seats ihres letzten Snapshots, während ein Kunde, dessen Key gelöscht wurde, sofort weg ist. Ein Abo, das keine Seat-Zahl meldet, lässt den Key fehlschlagen, statt 0 Seats abzurechnen. Die Bitwarden-Ansicht nennt den fehlschlagenden Key; die Key-Liste markiert aufgeteilte Keys mit „N Domain-Regeln“.

Self-hosted-Instanzen ​

Manche Lizenzen laufen auf einem Self-hosted-Bitwarden: Die Cloud-Organisation des Providers trägt die Seats, ihre Mitgliederliste enthält aber niemanden außer dem Owner des Providers — die Nutzer liegen auf dem Server des Kunden. Gib dem Key im Aufteilen-Dialog eine Mitglieder-Quelle: die Server-URL der Self-hosted-Instanz (nur der Host, etwa https://vault.example.com; ein eingefügtes /api oder /identity am Ende wird entfernt) und den Organisations-API-Key der Organisation auf dieser Instanz (deren Admin-Konsole: Einstellungen → Organisationsinfo → API-Key). Von da an lesen Dialog, Live-Ansicht und Snapshot die Mitglieder von der Instanz, die Seats kommen weiter vom Cloud-Key; die Key-Liste markiert solche Keys mit „self-hosted“. Wird die Quelle entfernt, zählen wieder die Mitglieder der Cloud-Organisation selbst.

Export der lizenzierten Nutzer ​

Lizenzierte Nutzer (CSV) in der Werkzeugleiste der Bitwarden-Ansicht exportiert die Mitglieder aller API-Keys, die einen Seat belegen — eingeladen, angenommen oder bestätigt, also die Mitglieder, die die Seats zählen —, als CSV-Datei, live aus der Mitgliederquelle jedes Keys gelesen (Cloud-Organisation oder Self-hosted-Instanz): Organisation (der Kunde des Keys), E-Mail, Name, Status, Zählt zu — der Kunde, dem der Seat eines Mitglieds nach den Domain-Regeln des Keys berechnet wird (ohne Regeln: der Kunde des Keys) — und die Mitgliederquelle. Die Kundenauswahl im Export-Dialog filtert nach Zählt zu. Einen Key, dessen Mitglieder sich nicht lesen lassen, nennt der Dialog; seine Mitglieder fehlen in diesem Export.

Besonderheiten ​

  • Der Kunde einer Domain-Regel zählt wie der Kunde des Keys als Kundenquelle (in der Kundenansicht schon vor dem ersten Snapshot gelistet, bei Zusammenführungen mit umbenannt).
  • Der Kundenname am API-Key ist die Kundenidentität — er zählt als Kundenquelle in der Kundenansicht (auch vor dem ersten Snapshot) und wird bei Zusammenführungen automatisch mit umbenannt.