Sandbox und Test-Clients

Jeder Verein kann eine Sandbox haben: einen Zwillingsverein mit demselben Erscheinungsbild, denselben Mitgliedsarten und demselben Statuto, gefüllt mit synthetischen Mitgliedern. Dort entwickeln und testen Sie, ohne echte Daten zu berühren und ohne eine Freigabe zu brauchen.

Jeder Entwickler, den die Plattform einlädt, hat außerdem eine eigene, die keinem Verein gehört: Er legt sie unter Kontoeinstellungen › Entwickler an, öffnet, erneuert und löscht sie dort und registriert darin seine Test-Clients.

Anlegen

In der Konsole Entwickler: die Schaltfläche Sandbox anlegen, oder registrieren Sie einen Client in der Umgebung Test — die Sandbox wird dann bei Bedarf angelegt. Wer sie anlegt, wird ihr Vorstandsmitglied: Über die Vereinsauswahl kann er sie öffnen und die Verwaltung mit den synthetischen Daten nutzen (einen Antrag genehmigen, eine Mitgliedschaft aussetzen, …).

Die synthetischen Mitglieder

Sechs Konten, eines pro Status, mit der E-Mail <state>@<slug>-sandbox.sandbox.invalid und einem gemeinsamen Passwort, das beim Anlegen und bei jedem Zurücksetzen einmal angezeigt wird:

E-Mail	Status	Wofür es steht
attivo@…	aktiv	gültiger Ausweis, Statuto akzeptiert — verdict: valid
in-attesa@…	ausstehend	Antrag noch nicht genehmigt
sospeso@…	ausgesetzt
revocato@…	widerrufen
scaduto@…	aktiv, aber abgelaufen	verdict: expired
statuto-da-accettare@…	aktiv, Statuto nicht akzeptiert	verdict: statuto_required

Sie melden sich über die normale Vimine-Anmeldeseite an, sodass Sie Mit Vimine anmelden von Anfang bis Ende ausprobieren können: Klick auf Ihrer Website → Anmeldung als attivo@… → Einwilligung → Callback → API.

Tipp

Um den Beitrittsantrag (membership:request) von jemandem auszuprobieren, der noch nicht Mitglied ist, melden Sie sich mit einem Konto an, das in dieser Sandbox keinen Ausweis hat, zum Beispiel mit einem persönlichen Konto: Die Einwilligung in die Beitrittsberechtigungen ist auch Nichtmitgliedern erlaubt.

Die Personen aus Ihren Tests

Wer sich über die Beitrittsseite der Sandbox anmeldet und wen ein Test-Client mit /v1/signup oder /v1/enroll benennt, wird zu einer synthetischen Person der Sandbox: Die eingegebene Adresse wird durch eine Adresse ihrer Domain ersetzt (api-…@<slug>-sandbox.sandbox.invalid, für dieselbe Adresse immer dieselbe), die die Seite am Ende des Beitritts anzeigt. Kein echtes Konto wird angelegt oder berührt, und keine E-Mail wird versendet.

Diese Konten gelten nur in der Sandbox: Sie melden sich dort mit dem gewählten Passwort an, können aber keinem echten Verein beitreten, keinen anderen öffnen und keinen Client autorisieren, der kein Test-Client ihrer Sandbox ist (sandbox_account).

Test-Clients

Ein Client in der Umgebung Test (vms_test_… bei vertraulichen) ist an die Sandbox gebunden, erscheint in der Konsole des echten Vereins, ist sofort aktiv und stellt Tokens mit mode: "test" aus. Er kann den echten Verein nicht berühren. E-Mails der Sandbox werden nicht versendet.

Für den Wechsel in die Produktion registrieren Sie einen zweiten Client in der Umgebung Production (mit denselben https-Redirect-URIs) und ändern, sobald er aktiviert ist, clientId in Ihrer Konfiguration: Der Code bleibt derselbe.

Zurücksetzen

Daten und Zugangsdaten neu erzeugen in der Konsole, oder mit einem Test-Client:

Node

import { VimineServer } from '@vimine/sdk/server';

const vimineServer = new VimineServer({ clientId: 'vmc_…', clientSecret: 'vms_test_…' });
await vimineServer.sandbox.members();                      // GET  /v1/sandbox
const { password } = await vimineServer.sandbox.reset();   // POST /v1/sandbox/reset — die Mitglieder fangen neu an, neues Passwort

Das Zurücksetzen erzeugt die sechs synthetischen Mitglieder neu (samt Einwilligungen und Sitzungen) und ändert ihr Passwort; die Personen aus Ihren Tests werden gelöscht; die Clients und die Sandbox bleiben. Diese Endpunkte verlangen das Token eines vertraulichen Test-Clients (client_credentials), kein HTTP Basic; ein Production-Client erhält 403.

Löschen

Sandbox löschen in der Konsole Entwickler (der Vorstand oder der Plattformbetreiber) löscht sie sofort, mit den synthetischen Mitgliedern, den Personen aus Ihren Tests, den Daten und den Test-Clients, die nicht mehr funktionieren. Sie können jederzeit eine neue anlegen.