Overview
Finding a good way to add user authorization to a Firebase and Next.js app was not the easiest out there to find. So I thought that I would write a tutorial that explains the process that I have pieced together, in the hopes that it could help others out as well.
The beauty in this method is all of your Firebase authentication is done on the server so you then have all of the necessary user data on hand for each request.
If you want to have authorized and protected routes, this way allows for a user authentication check on every page, as it lives in the _app.js
file. If you want to use this route only on specific pages you would add the getInitialProps
function to that specific page.
We are going to be creating a Firebase Token when the user logs in and then using the Next.js API routes we will be able to check is it is an authorized token with each page request. The user data is then available at the page level, making it available for any other components on your page.
We will be taking advantage of the Next.js feature for getInitialProps
. This allows you to render the page with data already populated, rather than waiting for your typical API data call in the useEffect
hook or class lifecycle method. This speeds up load time and ensures you have user data when you load the page.
I will be assuming familiarity with the basics of both Next.js and Firebase. If you have any questions about specifics for the _app.js
file or the api/validate
route do not hesitate to ask.
Let's get started.
The Process
First of all we need to create a UserContext.js
file. This is where going to create a Context Provider for all of the user data and Firebase functions. If you have never used the React Context API I wrote a basic tutorial that can help to explain more.
Although you could stop here and just pass the user data along through context, it would mean that you would have loading time on each page, rather than utilizing the Next.js feature for getInitialProps
.
We will put this all together later. But for now your UserContext.js
file should be similar to the following.
Right now we just have the login function, but you can also add in your logout, signup, or other Firebase functions here as well. I like to keep any user authentication functions in here and pass them through context to the proper components.
We will be use js-cookie to create and remove cookies.
You can install that with:
yarn add js-cookie
import React, { useEffect, useState } from 'react';
import cookie from 'js-cookie';
import firebase from '../firebaseSetup';
export const UserContext = React.createContext();
const tokenName = 'firebaseToken';
const UserProvider = ({ children }) => {
// Basic Firebase email login function.
const emailLogin = async (email, password, redirectPath) => {
await firebase
.auth()
.signInWithEmailAndPassword(email, password)
.then(() => {
console.log('User logged in.');
})
.catch((err) => {
console.log(err);
});
};
// Checks that user state has changed and then creates or destroys cookie with Firebase token.
const onAuthStateChange = () => {
return firebase.auth().onAuthStateChanged(async (user) => {
if (user) {
const token = await user.getIdToken();
cookie.set(tokenName, token, { expires: 14 });
} else {
cookie.remove(tokenName);
}
});
};
useEffect(() => {
const unsubscribe = onAuthStateChange();
return () => {
unsubscribe();
};
}, []);
return <UserContext.Provider value={{ emailLogin }}>{children}</UserContext.Provider>;
};
export default UserProvider;
The magic here lies in this section:
// Add or remove cookie with Firebase Auth Token on sign in or logout.
const onAuthStateChange = () => {
return firebase.auth().onAuthStateChanged(async (user) => {
if (user) {
const token = await user.getIdToken();
cookie.set(tokenName, token, { expires: 14 });
} else {
cookie.remove(tokenName);
}
});
};
useEffect(() => {
const unsubscribe = onAuthStateChange();
return () => {
unsubscribe();
};
}, []);
Here the onAuthStateChange
is called in the useEffect
hook. When a user logs in a cookie is created that stores the Firebase Authentication Token, or if they logout the cookie is destroyed. We will check that token through the Next.js API routes and do our user validation on the server side before the page loads. This will ensure that we do not have to wait for our user authentication with Firebase to take up any loading time.
Now in the _app.js
we will get our initial props. We need to add a getInitialProps
function to call the Next.js API routes and return the user data.
We will use fetch from "isomorphic-unfetch" and cookies with next-cookies for this file which can be added with:
yarn add isomorphic-unfetch next-cookies
Be sure to import it into _app.js
file.
MyApp.getInitialProps = async (appContext) => {
const { ctx } = appContext;
// Calls `getInitialProps` and fills `appProps.pageProps`
let error;
const appProps = await App.getInitialProps(appContext);
const { firebaseToken } = cookies(ctx);
// If token exists run Firebase validation on server side before rendering.
if (firebaseToken) {
try {
const headers = {
'Context-Type': 'application/json',
Authorization: JSON.stringify({ token: firebaseToken }),
};
const result = await fetch(`${server}/api/validate`, { headers }).then((res) => res.json());
return { ...result, ...appProps };
} catch (e) {
console.log(e);
}
}
return { ...appProps };
};
In order to have the correct server called for production and development you can use the following:
const dev = process.env.NODE_ENV === 'development';
const server = dev ? 'http://localhost:3000' : 'https://mydomain.com/';
One last thing is needed to tie the whole thing together. Now we need add in a Next.js API route. In your pages folder you need to create a api/validate.js
file. I highly suggest learning more about the Next.js API routes as they really help to take advantage of the SSR functionality that Next.js offers.
Here we are going to create the logic that populates our page with the Firebase data.
- A note here: You will need to create a Firebase Admin instance in order to use this, you cannot simply use a standard Firebase instance.
import { firebaseAdmin } from '../../utilities/firebaseAdminSetup';
const validate = async (token) => {
// Check that the user has a valid token
const decodedToken = await firebaseAdmin.auth().verifyIdToken(token, true);
let userData;
// Get user Firebase data from token
const user = await firebaseAdmin.auth().getUser(decodedToken.uid);
// Get any additional user data from the Firebase DB
await firebaseAdmin
.firestore()
.collection('users')
.doc(decodedToken.uid)
.get()
.then((doc) => {
if (doc.exists) {
userData = { ...doc.data() };
}
})
.catch((error) => {
console.log('Error getting document:', error);
});
// Assign the user result that will be passed to your _app.js file with populated data from the getUser and db functions
const result = {
user: {
uid: user.uid,
email: user.email,
username: userData.username,
emailVerified: user.emailVerified,
},
};
return result;
};
export default async (req, res) => {
try {
// Check if there is a token and if not return undefined.
const { token } = JSON.parse(req.headers.authorization || '{}');
if (!token) {
return res.status(403).send({
errorCode: 403,
message: 'Auth token missing.',
});
}
// Call the validate function above that gets the user data.
const result = await validate(token);
return res.status(200).send(result);
} catch (err) {
// Return undefined if there is no user. You may also send a different status or handle the error in any way that you wish.
console.log(err);
const result = undefined;
return res.status(200).send(result);
}
};
You now have user
available as props on any page route. Just pass it into the component as props in your _app.js
file. User validation is now a snap and now can be consumed by any other component.
This type of pattern comes in handy for any server side data fetching that you want to do. It is one of the great features of Next.js that you should try to utilize throughout your applications.
Top comments (11)
Am I reading this correctly, or would this require authorization for every single page in the app? How would I then differentiate from the pages that require auth vs the ones that don't? For instance, log in or home page don't require auth, but user's profile does, how do you then redirect away from the authenticated pages?
please can you share a repo for this example
I will try to get it up as a full working repo. Right now it is just from a project that I put together. I will try to put together a boiler plate example some time this week.
please in the _app.js cookies is not defined
I am sorry. I will update that I used 'next-cookies' to read them.
Edit:
Updated article that
_app.js
should usenext-cookies
Awesome tutorial. I needed a solution that was very small and flexible, with firestore users collection data. This is perfect!
There is no need for cookies I think, I would also use the new getServerSideProps instead of getInitialProps.
Can you give example code?
I wanted to understand, how you will get the user firebase token in server side without cookies?
Hi, What's the firebaseToken suppose to be?
Hi! How are you? Just in case the code is in a repository?
How can I use this validate function in a api route?