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