Firebase Admin SDK (Node.js) - Step-by-Step Execution

Process Flow - Firebase Admin SDK (Node.js)

Initialize Firebase Admin SDK

↓

Load service account credentials

↓

Create Firebase app instance

↓

Use Admin SDK services (Auth, Firestore, etc.)

↓

Perform operations (e.g., create user, read data)

↓

Handle results or errors

This flow shows how to set up the Firebase Admin SDK in Node.js, load credentials, create an app instance, and perform backend operations securely.

Execution Sample

Firebase

import admin from 'firebase-admin';

const serviceAccount = require('path/to/serviceAccountKey.json');

admin.initializeApp({
  credential: admin.credential.cert(serviceAccount)
});

async function createUser() {
  const user = await admin.auth().createUser({
    email: '[e-mail]',
    password: 'secret123'
  });
  return user;
}

This code initializes Firebase Admin SDK with credentials and creates a new user with email and password.

Process Table

Step	Action	Evaluation	Result
1	Import firebase-admin module	Module imported	admin object ready
2	Initialize app with serviceAccount	Credentials valid	Firebase app instance created
3	Call admin.auth().createUser()	Input: email and password	User creation request sent
4	Await user creation response	User created successfully	User object with uid returned
5	Handle errors if any	No errors	Process completes successfully

💡 User created and SDK ready for further operations

Status Tracker

Variable	Start	After Step 2	After Step 4	Final
admin	undefined	firebase-admin module object	firebase-admin module object	firebase-admin module object
app	undefined	Firebase app instance	Firebase app instance	Firebase app instance
user	undefined	undefined	{ uid: 'some-uid', email: '[e-mail]' }	{ uid: 'some-uid', email: '[e-mail]' }

Key Moments - 2 Insights

Why do we need to initialize the Firebase Admin SDK with credentials?

Initialization with credentials (Step 2) authenticates your server to Firebase, allowing secure backend operations. Without this, calls like createUser would fail.

What happens if createUser fails?

If createUser fails (Step 5), an error is thrown and should be caught to handle issues like invalid input or permission problems.

Visual Quiz - 3 Questions

Look at the execution table, what is the result after Step 3?

A User creation request sent

B User object with uid returned

C Firebase app instance created

D Module imported

💡 Hint

Check the 'Result' column for Step 3 in the execution_table

At which step is the Firebase app instance created?

A Step 1

B Step 2

C Step 4

D Step 5

💡 Hint

Look at the 'Result' column for Step 2 in the execution_table

If the serviceAccount credentials were invalid, which step would fail?

A Step 1

B Step 3

C Step 2

D Step 4

💡 Hint

Initialization with credentials happens at Step 2, check the 'Evaluation' column

Concept Snapshot

Firebase Admin SDK (Node.js) setup:
1. Import firebase-admin module
2. Initialize app with serviceAccount credentials
3. Use admin.auth() or other services
4. Perform backend operations like createUser
5. Handle results and errors
Secure server-side Firebase access

Full Transcript

This visual execution shows how to use the Firebase Admin SDK in Node.js. First, you import the firebase-admin module. Then, you initialize the SDK with your service account credentials to authenticate your server. After initialization, you create a Firebase app instance. Using this instance, you can call services like admin.auth() to create users or manage data securely. Each step is shown with the action, evaluation, and result. Variables like admin, app, and user change state as the code runs. Key moments include understanding why credentials are needed and how errors are handled. The quiz tests your understanding of the steps and their outcomes.

Practice

1. What is the primary purpose of the Firebase Admin SDK in Node.js?

easy

A. To build user interfaces for Firebase apps

B. To securely manage Firebase services from a server environment

C. To run Firebase apps directly in the browser

D. To replace Firebase client SDK on mobile devices

Solution

1. Step 1: Understand Firebase Admin SDK role

   The Admin SDK is designed for server-side use to manage Firebase services securely.

2. Step 2: Differentiate from client SDKs

   Client SDKs run on user devices for app interaction, while Admin SDK runs on servers for management tasks.

3. Final Answer:

   To securely manage Firebase services from a server environment -> Option B

4. Quick Check:

   Admin SDK = server management [OK]

Hint: Admin SDK is for backend server tasks, not frontend apps [OK]

Common Mistakes:

• Confusing Admin SDK with client SDK
• Thinking Admin SDK runs in browsers
• Assuming Admin SDK builds UI

2. Which of the following is the correct way to initialize the Firebase Admin SDK in Node.js using a service account JSON file named serviceAccountKey.json?

easy

A. const admin = require('firebase-admin');
admin.initializeApp({credential: admin.credential.cert(require('./serviceAccountKey.json'))});

B. const admin = require('firebase-admin');
admin.initializeApp({serviceAccount: 'serviceAccountKey.json'});

C. const admin = require('firebase-admin');
admin.initializeApp({credential: admin.credential.applicationDefault()});

D. const admin = require('firebase-admin');
admin.initializeApp({credential: admin.credential.cert(serviceAccountKey.json)});

Solution

1. Step 1: Load service account JSON correctly

   The service account JSON must be imported using require to pass the object, not a string path.

2. Step 2: Use admin.credential.cert with the JSON object

   Pass the imported JSON object to admin.credential.cert for proper initialization.

3. Final Answer:

   const admin = require('firebase-admin'); admin.initializeApp({credential: admin.credential.cert(require('./serviceAccountKey.json'))}); -> Option A

4. Quick Check:

   Use require() to load JSON for cert [OK]

Hint: Use require() to load JSON, not a string path [OK]

Common Mistakes:

• Passing file path string instead of JSON object
• Using applicationDefault() when service account is needed
• Incorrect property name like 'serviceAccount'

3. Given the following Node.js code using Firebase Admin SDK, what will be the output if the user with UID 'user123' exists?

const admin = require('firebase-admin');
admin.initializeApp();

admin.auth().getUser('user123')
  .then(userRecord => console.log(userRecord.uid))
  .catch(error => console.log('Error:', error.message));

medium

A. user123

B. Error: User not found

C. undefined

D. null

Solution

1. Step 1: Understand getUser() behavior

   getUser() returns a Promise resolving to a user record if the user exists.

2. Step 2: Check the then() callback output

   The code logs userRecord.uid, which will be 'user123' if the user exists.

3. Final Answer:

   user123 -> Option A

4. Quick Check:

   getUser() returns user data, logs UID [OK]

Hint: getUser() returns user info; log uid to see user ID [OK]

Common Mistakes:

• Assuming getUser() returns error if user exists
• Expecting undefined or null instead of UID
• Not handling Promise correctly

4. Identify the error in the following Firebase Admin SDK Node.js code snippet:

const admin = require('firebase-admin');
admin.initializeApp({
  credential: admin.credential.cert(serviceAccountKey.json)
});

admin.auth().createUser({
  email: '[e-mail]',
  password: 'secret123'
}).then(userRecord => console.log(userRecord.uid));

medium

A. initializeApp() cannot accept credential property

B. Password must be at least 10 characters

C. createUser() requires a displayName field

D. The service account JSON file path should be required, not passed as a string

Solution

1. Step 1: Check initialization of credential

   admin.credential.cert() expects a JSON object, not a string path. The file must be loaded with require().

2. Step 2: Validate other parameters

   Password length and displayName are optional or valid; initializeApp() accepts credential property.

3. Final Answer:

   The service account JSON file path should be required, not passed as a string -> Option D

4. Quick Check:

   Use require() to load JSON for cert [OK]

Hint: Load JSON with require(), not string path [OK]

Common Mistakes:

• Passing string path instead of JSON object
• Assuming password length error
• Thinking displayName is mandatory

5. You want to send a push notification to a device using Firebase Admin SDK in Node.js. Which sequence of steps correctly applies to achieve this?

hard

A. Use Firebase client SDK to send notification directly from server without Admin SDK

B. Initialize Admin SDK with credentials, call admin.auth().sendNotification(token, message), then handle response

C. Initialize Admin SDK with credentials, build a message object with token and notification, then call admin.messaging().send(message)

D. Initialize Admin SDK without credentials, build message, then call admin.database().send(message)

Solution

1. Step 1: Initialize Admin SDK properly

   Admin SDK must be initialized with credentials to access Firebase services securely.

2. Step 2: Create message object and send

   Build a message with device token and notification details, then use admin.messaging().send() to send it.

3. Final Answer:

   Initialize Admin SDK with credentials, build a message object with token and notification, then call admin.messaging().send(message) -> Option C

4. Quick Check:

   Use admin.messaging().send() with message object [OK]

Hint: Use admin.messaging().send() with message object and token [OK]

Common Mistakes:

• Using auth() instead of messaging() for notifications
• Trying to send without initializing SDK
• Using database() to send notifications