Guia de autenticação do Next.Js com Github e Typescript

O Next.js é um framework para React incrível com foco em eficiência, totalmente pré-configurado, que reúne diversas funcionalidades.

Nesse artigo irei abordar uma das funcionalidades no Next.Js, que é a autenticação de usuários com o provedor do Github. Ao final desse artigo você será capaz de criar um sistema de autenticação de usuário completo.

Criação do projeto

A primeira coisa que precisamos fazer é criar uma pasta em nossa máquina para o projeto.

Para criar nosso projeto precisamos primeiro acessar o diretório da pasta pelo terminal ou pelo editor de texto, como o exemplo abaixo:

Agora basta que rodemos o comando abaixo para criar um novo projeto Next:

yarn create next-app --typescript

No campo em que aparece em seu terminal informe o nome do projeto:

Precisamos agora acessar a pasta do projeto em nosso terminal:

cd .\next-auth-with-github\

Insira o comando abaixo no terminal para acessar nosso projeto no navegador:

yarn dev

Agora basta que acessemos a URL abaixo no navegador de preferência:

http://localhost:3000

Criação do OAuth

Agora que já estamos com o projeto criado precisamos criar um aplicativo OAuth em nosso Github para podermos consumi-lo posteriormente.

Clicando aqui seremos redirecionados para o painel de aplicativos OAuth do nosso Github. Agora clique no botão "New OAuth App" para criarmos um novo aplicativo OAuth.

A primeira coisa que precisamos fazer é informar o nome:

Com o nome informado agora iremos informar a URL do projeto:

E por último, informar a rota de callback do projet:

A rota deve ter exatamente essa URL!

Agora que os dados necessários já estão devidamente preenchidos clique no botão "Register application".

Veja que agora obtivemos dois dados importantes:

• Client ID
• Client secrets

Mão na massa

Agora que já criamos nosso projeto e também criamos um aplicativo OAuth podemos de fato "colocar a mão na massa".

Criando variável ambiente

Na raiz de seu projeto, crie o arquivo .env.local. Esse arquivo será responsável por conter todas as chaves de configurações com serviços externos ao nosso projeto.

Com o arquivo criado, vamos criar as variáveis e atribuí-las os seus devidos valores.

Declare essas duas variáveis em seu arquivo .env.local:

CLIENT_ID=
CLIENT_SECRET=

Agora basta que atribuímos a essas variáveis seus valores de acordo com o Github OAuth:

Tendo como resultado final:

Estruturando página index e aplicando-a estilos

Acesse o arquivo index.tsx dentro da pasta pages e vamos estruturar nossa página:

import type { NextPage } from 'next'
import styles from '../styles/Home.module.css'

const Home: NextPage = () => {
  return (
    <div className={styles.container}>
      <div className={styles.box}>
        <button className={`${styles.button}`}>
          Fazer login
        </button>
      </div>
    </div>
  )
}

export default Home

No arquivo global.css dentro da pasta styles adicione os seguintes estilos globais:

* {
  margin: 0;
  padding: 0;
  box-sizing: border-box;
}

:root {
  --white: #fff;
  --gray-100: #e1e1e6;
  --gray-300: #a8a8b3;
  --gray-800: #29292e;
  --gray-850: #212529;
  --gray-900: #121214;
  --green-900: #3e8914;
  --yellow-500: #eba417;
}

@media (max-width: 1080px) {
  html {
    font-size: 93.75%;
  }
}

@media (max-width: 720px) {
  html {
    font-size: 87.5%;
  }
}

body {
  background: var(--gray-900);
  color: var(--white);
  overflow-x: hidden;
}

body,
input,
textarea,
select,
button {
  font: 400 1rem sans-serif;
}

button {
  cursor: pointer;
}

a {
  color: inherit;
  text-decoration: none;
}

ul{
  list-style-type: none;
}

No arquivo Home.module.css dentro da pasta styles adicione os seguintes estilos:

.container {
  width: 100%;
  min-height: 100vh;
  display: flex;
  align-items: center;
  justify-content: center;
}

.box {
  padding: 2rem 4rem;
  border-radius: 0.25rem;
  background-color: var(--gray-800);
}

.button {
  padding: 0.5rem 2rem;
  border-radius: 0.25rem;
  background-color: var(--yellow-500);
  border: 0;
  color: var(--gray-800);
  font-size: 1rem;
  transition: 0.2s;
}

.button:hover {
  filter: brightness(0.8);
}



.button.active {
  background-color: var(--green-900);
}

Configurando provedor do Github

Em nosso projeto existe uma pasta chamada api, essa pasta é responsável por interpretar arquivos do lado do servidor, nela crie uma pasta chamada auth e dentro dessa pasta, crie o arquivo [...nextauth].ts. Esse arquivo será responsável pelas configurações de provedores.

Agora que o arquivo [...nextauth].ts iremos instalar o pacote de autenticação do Next:

yarn add next-auth

Agora iremos configurar o provedor do Github em nosso arquivivo [...nextauth].ts:

import NextAuth from 'next-auth'
import GithubProvider from 'next-auth/providers/github'

export const authOptions = {
  providers: [
    GithubProvider({
      clientId: process.env.CLIENT_ID!,
      clientSecret: process.env.CLIENT_SECRET!
    })
  ]
}

export default NextAuth(authOptions)

Criando contexto de sessão

Em nosso arquivo _app.tsx dentro da pasta pages, iremos criar um contexto com a sessão de usuário:

import '../styles/globals.css'
import type { AppProps } from 'next/app'
import { SessionProvider } from 'next-auth/react'
import { Session } from 'next-auth'

function MyApp({
  Component,
  pageProps: { session, ...pageProps }
}: AppProps<{
  session: Session
}>) {
  return (
    <SessionProvider session={session} basePath="/api/auth/callback">
      <Component {...pageProps} />
    </SessionProvider>
  )
}

export default MyApp

Consumindo contxto

Agora iremos verificar se nossa sessão está ativa ou não. No arquivo index.tsx dentro da pasta pages insira o seguinte código:

import type { NextPage } from 'next'
import { useSession, signIn, signOut } from 'next-auth/react'
import styles from '../styles/Home.module.css'

const Home: NextPage = () => {
  const { data: session } = useSession()

  return (
    <div className={styles.container}>
      <div className={styles.box}>
        {!session ? (
          <button className={styles.button} onClick={() => signIn('github')}>
            Fazer login
          </button>
        ) : (
          <button
            className={`${styles.button} ${styles.active}`}
            onClick={() => signOut()}
          >
            {session.user?.name}
          </button>
        )}
      </div>
    </div>
  )
}

export default Home

Finalizando...

Agora que já configuramos tudo iremos testar. O Next recomenda que quando utilizamos variáveis ambiente é sempre importante que reiniciemos o servidor após configura-las, então, vá até o seu terminal, pare o servidor e o suba novamente utilizando o comando abaixo:

yarn dev

Então, se você fez tudo corretamente, agora é só clicar no botão de login e realizar o seu login com o Github!

---

Feito com ❤ por Pablo Ferrari