PASS 인증 연동 - PASS injeung yeondong

• 공통 가이드
• 개발 가이드
• 디자인 가이드

개발 가이드

연동 가이드

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

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

[자동로그인 관련]

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

[WebView 관련]

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

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

HTTPS

• GET
• POST

파라미터에 대해서 파라미터, 타입, 필수여부, 설명으로 분류되어 내용을 제공하는 테이블

[PC/Mobile Web]

https://id.passlogin.com/oauth2/authorize?client_id=clientId2&redirect_uri=https%3A%2F%2Fwww.sample.com%2Flogin_callback&response_type=code&state=12345&prompt=select_account

[WebView]

https://id.passlogin.com/oauth2/authorize?client_id=clientId2&redirect_uri=https%3A%2F%2Fwww.sample.com%2Flogin_callback&response_type=code&state=12345&isHybrid=Y

응답에 대해서 파라미터, 타입, 필수여부로 분류되어 제공되는 테이블

정상 응답

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 발급)

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

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

HTTPS

POST

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

파라미터에 대해서 파라미터, 타입, 필수여부, 설명으로 분류되어 내용을 제공하는 테이블

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'

응답에 대해서 파라미터, 타입, 설명으로 분류되어 내용을 제공하는 테이블

정상 응답

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"
}

에러코드 안내

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

에러코드에 대해서 에러코드, 에러 메시지, 조치방안으로 분류되어 내용을 제공하는 테이블