[FR] Documentation on using impersonation with Realtime Database Emulator

[akauppi]

Is your feature request related to a problem? Please describe.

I'd like to use firebase-admin for testing of Firebase Realtime Database access rules. I'm not sure how to intialize the library, to make it reliably connect to the emulator.

Documentation has Authenticate with limited privileges but the samples it gives are real-world, not emulator URLs.

Describe the solution you'd like

Documentation showing the initialization steps that work with Firebase Realtime Database emulator.

Describe alternatives you've considered

I think I had this code working, but now it fails.

const databaseURL = `http://localhost:6800?ns=demo-2`;

const app = admin.initializeApp({
  databaseURL,
  databaseAuthVariableOverride: { uid },
  projectId
});

Gives (firebase-admin 11.0.0):

Error: Client is offline.

I'll keep looking and post here if I find something that works.

---

Related:

• RTDB emulator doesn't work properly with databaseAuthVariableOverride (firebase-tools GitHub Issues)

[google-oss-bot]

I found a few problems with this issue:

• I couldn't figure out how to label this issue, so I've labeled it for a human to triage. Hang tight.
• This issue does not seem to follow the issue template. Make sure you provide all the required information.

[akauppi]

This could be a good page for the addition:

https://firebase.google.com/docs/admin/setup

[rhodgkins]

There's already documentation for properly (using an emulator URL as the databaseURL isn't the "proper" way), and then databaseAuthVariableOverride just works as normal - granted there are some issues related to using the auth variable in the rules, but that what's firebase/firebase-tools#2554 is about.

[akauppi]

Thanks, @rhodgkins

I believe this is a duplicate of firebase/firebase-js-sdk#6390 .