[스프링부트3개발자되기] 10장 : OAuth2로 로그인/로그아웃 구현하기

10.1 사전 지식 : 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에서 가장 잘 알려진 인증 방법이다.

 

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

  애플리케이션, 리소스 오너, 리소스 서버, 인증 서버의 인증 순서는 다음과 같다.

 

 

 

권한 요청

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

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

 

데이터 접근용 권한 부여

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

 

 

인증 코드 제공

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

 

 

액세스 토큰 응답

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

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

 

 

 

액세스 토큰으로 API 응답&반환

  이때 제공받은 액세스 토큰으로 리소스 오너의 정보를 가져올 수 있다. 정보가 필요할 때마다 API 호출을 통해 정보를 가져오고 리소스 서버는 토큰이 유효한지 검사한 뒤에 응답한다.

 

10.1.3 쿠키

  쿠키란 사용자가 어떤 웹사이트를 방문했을 때 해당 웹사이트의 서버에서 로컬 환경에 저장하는 작은 데이터를 의미한다. 이 값이 있기 때문에 이전에 방문한 적이 있는지 알 수 있고, 이전에 로그인을 했다면 로그인 정보도 유지할 수 있다. 이 값을 통해 이전의 방문 여부, 이전의 로그인 정보 유지가 가능하다. 쿠키는 키와 값으로 이루어져 있고 만료 기간, 도메인 등의 정보를 가지고 있다. HTTP 요청을 통해 쿠키의 특정 키에 값을 추가할 수 있다. 쿠키의 추가 과정은 다음과 같다.

  클라이언트가 정보를 요청하면 서버에서 정보를 값으로 넣은 쿠키를 생성해서 요청한 정보(==HTTP 헤더) 와 함께 돌려보낸다. 그럼 클라이언트는 로컬(==브라우저)에 쿠키를 저장한다. 이후 사이트에 재방문할 때는 사용자가 로컬 환경에 있는 쿠키와 함께 서버에 요청한다. 

 

실행 예

•   프론트에서 POST 요청을 보낼 때 액세스 토큰도 함께 보낸다.
•   만약 응답에 권한이 없다는 에러 코드가 발생하면(=백에서 구현해둠) 리프레시 토큰과 함께 새로운 액세스 토큰을 요청한다.
  • 리프레시 토큰은 새로운 액세스 토큰을 발급받는 데에 사용한다.
  • 그리고 백에서 리프레시 토큰을 쿠키에 저장해두도록 했다.
• 다시 전달받은 액세스 토큰으로 원래 요청하려 했던 POST API 를 호출한다.

 

1. 쿠키 : 사용자가 웹사이트를 방문했을 때 웹사이트가 사용하는 서버를 통해 로컬에 저장되는 작은 데이터. 키와 값으로 이루어져 있으며 만료 기간, 도메인 등의 정보를 가지고 있다.
2. OAuth2 : 제 3의 서비스에게 계정을 맡기는 방식. 정보를 취득하는 방법으로는 권한 부여 코드 승인 타입, 암시적 승인 타입, 리소스 소유자 암호 자격증명 승인 타입, 클라이언트 자격증명 승인 타입이 있다.
3. OAuth 방식 중 권한 부여 코드 승인 타입은 클라이언트가 리소스에 접근하는 데 사용되며, 권한에 접근할 수 있는 코드를 제공받으면 리소스 오너에 대한 액세스 토큰을 제공받게 된다.