🛠️ Authentik OAuth Provider 개요

 

🛠️ Authentik OAuth Provider 개요

Authentik는 오픈소스 인증 서버로, OAuth 2.0 및 **OpenID Connect (OIDC)**를 지원합니다.
NextAuth.js와 연동하여 사용자 인증을 손쉽게 구현할 수 있습니다.

---

📦 기본 설정 예시 (pages/api/auth/[...nextauth].ts)

import NextAuth from "next-auth"
import AuthentikProvider from "next-auth/providers/authentik"

export default NextAuth({
  providers: [
    AuthentikProvider({
      clientId: process.env.AUTHENTIK_CLIENT_ID,
      clientSecret: process.env.AUTHENTIK_CLIENT_SECRET,
      issuer: process.env.AUTHENTIK_ISSUER,
    }),
  ],
})

---

📑 환경 변수 설정 (.env)

AUTHENTIK_CLIENT_ID=your-authentik-client-id
AUTHENTIK_CLIENT_SECRET=your-authentik-client-secret
AUTHENTIK_ISSUER=https://auth.example.com
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your-nextauth-secret

---

🌐 Authentik 애플리케이션 설정

1. Authentik Admin Panel에 접속
2. OAuth2 Provider를 추가하여 Client ID와 Client Secret을 발급
3. Redirect URI 설정:
4. http://localhost:3000/api/auth/callback/authentik
5. 권한 범위(Scope):
   • openid
   • profile
   • email

---

🔄 토큰 설정

사용자 정보 가져오기

async function jwt({ token, account }) {
  if (account?.provider === "authentik") {
    token.accessToken = account.access_token
  }
  return token
}

세션에 포함시키기

async function session({ session, token }) {
  session.accessToken = token.accessToken
  return session
}

---

🗺️ 사용자 정보 표시 예제

반응형

import { useSession } from "next-auth/react"

export default function Profile() {
  const { data: session } = useSession()
  return (
    <>
      <p>Signed in as {session?.user?.name}</p>
      <p>Access Token: {session?.accessToken}</p>
    </>
  )
}

---

⚠️ 주의사항

• Authentik 인스턴스 설정이 올바르지 않으면 로그인 오류가 발생할 수 있습니다.
• Issuer URL이 정확히 맞아야 인증이 정상 처리됩니다.
  예: https://auth.example.com

---

 

NextAuth Authentik, Authentik OAuth 설정, Next.js 인증 구현, Authentik Client ID 설정, OpenID Connect 연동, 사용자 세션 관리, NextAuth 인증 처리, Authentik 사용자 정보 가져오기, OAuth2 인증 처리, SEO 최적화 10개