1. 휴대폰번호 로그인 인증 요청 (Authorization code 발급)

1.1 설명

• 휴대폰번호 로그인은 OAuth2.0 프레임워크를 사용하여 PASS 사용자의 인증을 진행합니다.
• 개발자센터에 애플리케이션이 등록되어 있어야 합니다. (애플리케이션 등록 방법 링크)
• 사용자가 PASS앱을 통해 인증에 성공하면 콜백 URL로 인증 코드(authorization code)를 반환받습니다.
• 사용자의 웹 브라우저에서 요청되어야 합니다.
• 이 요청으로 휴대폰번호 로그인 인증 요청 페이지가 호출됩니다.
• 처음 휴대폰번호 로그인 인증하는 사용자의 경우 제 3자 정보제공 동의 페이지가 노출됩니다. (여기서 애플리케이션 등록시 설정한 제공정보들이 노출됩니다)
• 인증 코드(Authorization Code)는 발급 후 1분동안 유효합니다.

[자동로그인 관련]

• SKT 사용자에 한해서만 기능을 제공합니다.
• 휴대폰번호 로그인 SDK를 사용 할 경우 제휴사의 App.에서도 자동로그인 기능을 사용 할 수 있습니다.
• 사용자에게 발급 된 자동로그인 정보는 2주간 유효합니다.
• 자동로그인 해지는 SKT PASS앱 내 자동로그인 설정 메뉴를 통해 제공됩니다.
• SKT PASS 앱에서 휴대폰번호 로그인 서비스를 해지 할 경우 자동로그인 기능은 즉시 해지됩니다.

[WebView 관련]

• 제휴사 App.에서는 WebView를 활용하여 PASS 로그인 모바일 화면을 요청 할 수 있습니다.
• isHybrid 파라미터를 설정 할 경우 Native에서 처리 할 JavaScript Function을 최소화합니다.
• 하이브리드 환경에 제공되는 휴대폰번호 로그인 모바일 화면은 Mobile Browser를 통해 제공되는 화면과 차이가 있습니다.
• 하이브리드 환경에서는 자동로그인 기능을 제공하지 않습니다. (휴대폰번호 로그인 SDK 사용 시 사용 가능)

1.2 요청 URL

URL : https://id.passlogin.com/oauth2/authorize?response_type=code&client_id={client_id}&redirect_uri={encoded_redirect_uri}&state={encoded_state}&prompt={prompt}&isHybrid=Y

1.3 프로토콜

HTTPS

1.4 HTTP메서드

• GET
• POST

1.5파라미터

1.6 요청 예

1.7 응답

1.8 응답 예

HTTP/1.1 302 Found
Location: https://www.sample.com/login_callback?code=0fdVa6&state=12345

HTTP/1.1 400
{
    "error" : "invalid_request",
    "message" : "parameter error"
}

2. 휴대폰번호 로그인 액세스 토큰 발급 요청 (Access Token 발급)

2.1 설명

• 휴대폰번호 로그인 API를 사용하기 위한 액세스 토큰의 발급을 요청합니다.
• 휴대폰번호 로그인 API는 사용자의 기본 정보를 조회할 때 사용합니다.
• server-to-server 호출을 권장합니다.
• 액세스 토큰의 유효시간은 10분입니다.

2.2 요청 URL

URL : https://id.passlogin.com/oauth2/token?grant_type={grant_type}&client_id={client_id}&client_secret={client_secret}&code={code}&state={encoded_state}

2.3 프로토콜

HTTPS

2.4 HTTP메서드

POST

2.5 요청헤더

Authorization: Basic {base64_encode({client_id}:{client_Secret})}
Content-Type: application/x-www-form-urlencoded

2.6 파라미터

2.7 요청 예

curl -X POST
'https://id.passlogin.com/oauth2/token'
-H 'Authorization: Basic Y2xpZW50SWQyOm1DbGllbnRTZWNyZXQ='
-H 'Content-Type: application/x-www-form-urlencoded'
-d 'grant_type=authorization_code'
-d 'code=0fdVa6'
-d 'state=12345'

2.8 응답

2.9 응답 예

HTTP/1.1 200 OK
{
    "access_token":"G/Tit+vKtqcj3rGTvqdGzWN5JskQuts5Tx4qGennVVxr/dNbRf88qBviQAWBtKDKnIeWM8Wca6XIO/H9MW1JYHaVXFqhQR8l9ezk8x+2XX8=",
    "token_type":"bearer",
    "expires_in":"3600",
    "state":"12345"
}

HTTP/1.1 500 Internal Server Error
{
    "error" : "server_error",
    "message" : "Invalid authorization code: 0fdVa6"
}

에러코드 안내

에러 코드 별 설명 및 조치 방안을 안내합니다.