Connectors
Firebase connector
Let Limenia disable and enable Firebase Authentication accounts directly when moderators suspend, ban or restore a user.
Connectors carry out decisions directly in your services, in addition to the webhook; they never replace it. Your app still enforces restrictions itself. Setup is done by an admin in the dashboard (tab Connectors), which shows the exact commands with your IDs. None of them needs code in your app beyond the right user IDs. Connectors need a plan that includes them.
What it does
On suspend_user/ban_user Limenia disables the Firebase Authentication account and revokes its refresh tokens; on restore with restoreScope: account and at the end of a suspension it enables it again. restore with restoreScope: content and decisions on reviews never touch the account.
Requirements
The externalUserId you send is the Firebase UID (otherwise user_not_found in the delivery log, no retry).
Setup
Enter the Firebase project ID; create a custom role with firebaseauth.users.get, firebaseauth.users.update and resourcemanager.projects.get and grant it to the service account the dashboard shows; prove ownership with the project label limenia-tenant=<tenant ID in lower case>; enable and press Check access. A Firebase project can be connected to one app only.
Token lifetime
ID tokens already issued stay valid up to one hour (Firebase behaviour). Verify tokens with verifyIdToken(token, true) (check revoked) where bans must take effect immediately.
Errors in the delivery log
Each connector call appears in the Delivery log next to the webhook delivery.
| Code | Meaning | Retried? |
|---|---|---|
user_not_found |
No Firebase user with this UID: the externalUserId is not the Firebase UID |
no |
ownership_not_proven |
The project label limenia-tenant is missing or wrong |
no |
permission_denied |
The service account lacks the custom role | yes |
project_not_found |
Wrong Firebase project ID | yes |
not_configured |
The connector was switched off or is incomplete | no |
timeout, unavailable |
Firebase did not answer in time or is unavailable | yes |