[스프링] 어바웃 OAuth2 & 구글 토큰 발급받기

🖥️ 백엔드/스프링

[스프링] 어바웃 OAuth2 & 구글 토큰 발급받기

케로⸝⸝◜࿀◝ ⸝⸝ 2024. 6. 6. 22:23

[스프링] 토큰 기반 인증과 JWT

토큰 기반 인증이란?사용자가 서버에 접근할 때 이 사용자가 인증된 사용자인지 확인하는 방법은 다양하다.대표적인 사용자 인증 확인 방법은 2가지세션 기반 인증토큰 기반 인증세션 기반 인

progfrog.tistory.com

OAuth란?

OAuth는 제3의 서비스에 계정 관리를 맡기는 방식
네이버 로그인, 구글 로그인 등

OAuth 용어	설명
리소스 오너(resource owner)	자신의 정보를 사용하도록 인증 서버에 허가하는 주체 서비스를 이용하는 사용자가 리소스 오너에 해당
리소스 서버(resource server)	리소스 오너의 정보를 가지며, 리소스 오너의 정보를 보호하는 주체 네이버, 구글, 페이스북 등이 리소스 서버에 해당
인증 서버(authorization server)	클라이언트에게 리소스 오너의 정보에 접근할 수 있는 토큰을 발급하는 역할을 하는 애플리케이션
클라이언트 애플리케이션(client application)	인증 서버에게 인증을 받고 리소스 오너의 리소스를 사용하는 주체

OAuth를 사용하면 인증 서버에서 발급받은 토큰을 사용해서 리소스 서버에 리소스 오너의 정보를 요청하고 응답받아 사용할 수 있다.
클라이언트는 어떻게 리소스 오너의 정보를 취득할 수 있을까? 리소스 오너의 정보를 취득할 수 있는 방법은 4가지가 있다.
1. 권한 부여 코드 승인 타입(authorization code grant type)
  - OAuth 2.0에서 가장 잘 알려진 인증 방법
  - 클라이언트가 리소스에 접근하는 데 사용하며, 권한에 접근할 수 있는 코드와 리소스 오너에 대한 액세스 토큰을 발급받는 방식
2. 암시적 승인 타입(implicit grant type)
  - 서버가 없는 자바스크립트 웹 애플리케이션 클라이언트에서 주로 사용하는 방법
  - 클라이언트가 요청을 보내면 리소스 오너의 인증 과정 이외에는 권한 코드 교환 등의 별다른 인증 과정을 거치지 않고 액세스 토큰을 제공받는 방식
3. 리소스 소유자 암호 자격증명 승인 타입(resource owner password credentials)
  - 클라이언트의 패스워드를 이용해서 액세스 토큰에 대한 사용자의 자격 증명을 교환하는 방식
4. 클라이언트 자격증명 승인 타입(client credentials grant)
  - 클라이언트가 컨텍스트 외부에서 액세스 토큰을 얻어 특정 리소스에 접근을 요청할 때 사용하는 방식

여기서는 권한 부여 코드 승인 타입을 중심으로 설명한다. 이 방법은 서비스에서 가장 중요한 정보인 사용자 데이터가 외부로 전송되지 않아 안전하고, OAuth에서 가장 잘 알려진 인증 방법이기도 하다.

권한 부여 코드 승인 타입이란?

1. 권한 요청이란?

권한 요청은 클라이언트(스프링 부트 서버)가 특정 사용자 데이터에 접근하기 위해 권한 서버(카카오, 구글, ...)에 요청을 보내는 것
요청 URI는 권한 서버마다 다르지만 보통은 클라이언트 ID, 리다이렉트 URI, 응답 타입 등으로 파라미터를 보낸다.

권한 요청을 위한 파라미터 예

GET spring-authorization-server .example /authorize?
client_id=66a36b4c2&
redirect_uri=http://localhost:8080/myapp&
response_type=code&
scope=profile

client_id
- 인증 서버가 클라이언트에 할당한 고유 식별자
- 이 값은 클라이언트 애플리케이션을 OAuth 서비스에 등록할 때 서비스에서 생성하는 값
redirect_uri
- 로그인 시 이동해야 하는 URI
response_type
- 클라이언트가 제공받길 원하는 응답 타입
- 인증 코드를 받을 때는 code 값을 포함해야 한다.
scope
- 제공받고자 하는 리소스 오너의 정보 목록

2. 데이터 접근용 권한 부여

인증 서버에 요청을 처음 보내는 경우 사용자에게 보이는 페이지를 로그인 페이지로 변경하고 사용자의 데이터에 접근 동의를 얻는다.
이 과정은 최초 1회만 진행
이후에는 인증 서버에서 동의 내용을 저장하고 있기 때문에 로그인만 진행한다.
로그인이 성공되면 권한 부여 서버는 데이터에 접근할 수 있게 인증 및 권한 부여를 수신한다.

3. 인증 코드 제공

사용자가 로그인에 성공하면 권한 요청 시에 파라미터로 보낸 redirect_uri로 리다이렉션 된다.
이때, 파라미터에 인증 코드를 함께 제공한다.

인증 코드 예

GET http://localhost:8080/myapp?code=a1s2f3mcj2

4. 액세스 토큰 응답이란?

인증 코드를 받으면 액세스 토큰으로 교환해야 한다.
액세스 토큰은 로그인 세션에 대한 보안 자격을 증명하는 식별 코드를 의미한다.
보통 다음과 같이 /token POST 요청을 보낸다.

/token POST 요청 예

POST spring-authorization-server.example.com/token
{
"client_id": "66a36b4c2",
"client_secret": "aabb11dd44",
"redirect_uri": "http://localhost:8080/myapp",
"grant_type": "authorization_code",
"code": "a1b2c3d4e5f6g7h8"
}

client_server
- OAuth 서비스에 등록할 때 제공받는 비밀키
grant_type
- 권한 유형을 확인하는 데 사용
- 이때는 authorization_code로 설정해야 한다.
- 권한 서버는 요청 값을 기반으로 유효한 정보인지 확인하고, 유효한 정보라면 아래 예시와 같이 액세스 토큰으로 응답한다.