• Spotnana UI가 Spotnana 서버에 사용자의 인증 설정 정보를 요청하는 API를 보냅니다. 이 요청에는 사용자의 로그인 자격 정보가 포함됩니다.
• 응답에는 사용자의 tmcId, orgId와 authProviderType이 포함되어 있습니다.

• Spotnana UI가 Spotnana IdP에 clientId, 이메일, 비밀번호를 전달하여 API 요청을 보냅니다. Spotnana IdP에서 새로운 bearer 토큰이 생성되어 Spotnana UI로 반환됩니다.
• 이 단계에서 사용자가 인증됩니다.

• 2단계에서 인증이 완료되면, 이후 모든 API 요청에는 bearer 토큰과 orgId, 그리고 tmcId 가 요청 헤더에 포함되어야 합니다.
• 모든 API 요청에서 bearer 토큰이 검증되며, 그 결과가 Spotnana UI로 반환됩니다.

• Spotnana UI가 Spotnana 서버에 사용자의 인증 설정 정보를 요청하는 API를 보냅니다. 이 요청에는 사용자의 로그인 자격 정보가 포함됩니다.
• 응답에는 사용자의 tmcId, orgId와 authProviderType이 포함되어 있습니다.

사용자가 새 비밀번호를 입력한 뒤 다음을 클릭합니다.

• Spotnana UI가 Spotnana IdP에 회원가입 요청을 보냅니다. 이때 clientId, 이메일, 새 비밀번호가 함께 전달됩니다.
• 정보 등록이 완료되면, 사용자의 이메일로 일회용 비밀번호(OTP)가 발송됩니다.

• 사용자가 Spotnana UI에 OTP를 입력한 뒤 인증을 클릭합니다.
• Spotnana UI가 Spotnana IdP에 OTP 검증 및 로그인용 bearer 토큰 생성을 요청합니다.
• bearer 토큰이 생성되어 Spotnana UI로 반환됩니다. 이로써 사용자가 Spotnana 플랫폼에 bearer 토큰으로 접근할 수 있게 인증이 완료됩니다.

• 3단계에서 인증이 완료되면, 이후 모든 API 요청에는 bearer 토큰과 orgId, 그리고 tmcId 가 요청 헤더에 포함되어야 합니다.
• 모든 API 요청에서 bearer 토큰이 검증되며, 그 결과가 Spotnana UI로 반환됩니다.

• Spotnana UI가 Spotnana 서버에 사용자의 인증 설정 정보를 요청하는 API를 보냅니다. 이 요청에는 사용자의 로그인 자격 정보가 포함됩니다.
• 응답에는 사용자의 tmcId, orgId와 authProviderType이 포함되어 있습니다.

Spotnana UI가 요청을 Spotnana IdP로 리다이렉트합니다.

Spotnana IdP가 요청을 파트너의 IdP로 리다이렉트하여, 사용자의 IdP 인증을 시작합니다.

참고: 각 리다이렉트 단계마다 302 상태 코드가 반환되어, 요청이 다른 URL로 이동했음을 나타냅니다.

Spotnana IdP와 파트너 IdP 간 연결이 이루어지며, 이를 통해 파트너 IdP에서 사용자가 인증되었는지 확인합니다.

참고: 이 연결 과정에서 Spotnana IdP는 clientId 와 clientSecret 을 form URL-encoded 데이터로 파트너 IdP에 API 호출로 전달합니다. 만약 IdP 서버가 이 데이터 형식을 처리하지 못할 경우, Spotnana 서버가 프록시 역할을 하여 파트너 IdP가 인식할 수 있는 형식으로 변환해 전달할 수 있습니다.

파트너 IdP에서 사용자가 정상적으로 인증됩니다.

참고: 이 단계 이후에도 사용자 프로필은 bearer 토큰 검증을 거쳐야 합니다.

인증이 완료되면, 파트너 IdP의 응답이 Spotnana IdP로 전달됩니다.

Spotnana IdP가 사용자 프로필에 대한 고유 코드를 생성하여 Spotnana UI로 전달합니다.

• Spotnana UI가 5(b) 단계에서 받은 코드와 함께 clientID 를 Spotnana IdP에 API로 요청합니다.
• Spotnana IdP가 새로운 bearer 토큰을 생성하여 Spotnana UI로 전달합니다.

참고: bearer 토큰이 정상적으로 생성되면, 사용자가 인증되어 Spotnana에 접근할 수 있음을 의미합니다.

• 6단계에서 인증이 완료되면, 이후 모든 API 요청에는 bearer 토큰과 orgId, 그리고 tmcId 가 요청 헤더에 포함되어야 합니다.
• 모든 API 요청에서 bearer 토큰이 검증되며, 그 결과가 Spotnana UI로 반환됩니다.

API 사용자가 POST 방식으로 get-auth-token(clientId,clientSecret) Spotnana 서버의 API 엔드포인트에 호출하여 임시 bearer 토큰을 발급받습니다.

아래는 get-auth-token 엔드포인트 호출 시 사용할 수 있는 cURL 예시입니다.

curl -i -X POST \
https://api.spotnana.com/get-auth-token \
-H 'Content-Type: application/json' \
-d '{
  "clientId": "sample-apiuser@tmcorg.com",
  "clientSecret": "<password>"
}'

참고: Spotnana에서 받은 clientId 와 clientSecret 값으로 바꿔서 사용하셔야 합니다. 

• Spotnana 서버가 Spotnana IdP의 getToken(clientId,clientSecret) 메서드를 호출해 임시 bearerToken 을 생성하고, 다시 Spotnana 서버로 전달합니다.
• Spotnana 서버는 이 bearer 토큰을 JSON 응답으로 API 사용자에게 전달합니다.

파트너 UI가 파트너 서버에 OAuth 토큰 요청을 보내며, 이로써 인증 흐름의 다음 단계가 시작됩니다.

파트너 서버가 사용자 자격 정보와 subject token을 파라미터로 Spotnana 서버에 요청을 보냅니다. Spotnana 서버는 이 요청이 API/머신 사용자에 의해 보내졌는지 확인합니다.

• Spotnana 서버가 파트너 서버에 subject(즉, caller)의 이메일을 요청합니다.
• 이메일이 조회되어 Spotnana 서버로 전달되며, 이를 통해 사용자를 식별합니다.

• 1단계 API 요청에 대한 응답으로 Spotnana 서버가 파트너 서버에 access token과 refresh token을 전달합니다.
• 이 정보는 다시 파트너 UI로 전달됩니다.

파트너 UI가 post message로 Spotnana UI에 토큰(type=TOKEN_EXCHANGE_RESPONSE)을 전달합니다. type=TOKEN_EXCHANGE_RESPONSE.

• Spotnana UI가 Spotnana 서버에 API 요청을 보내 새 bearer 토큰을 발급받습니다.
• Spotnana 서버에서 bearer 토큰이 생성되어 Spotnana UI로 반환됩니다.

참고: bearer 토큰이 정상적으로 생성되면, 사용자가 인증되어 Spotnana에 접근할 수 있음을 의미합니다.

• 3단계에서 인증이 완료되면, 이후 모든 API 요청에는 bearer 토큰과 orgId, 그리고 tmcId 가 요청 헤더에 포함되어야 합니다.
• 모든 API 요청에서 bearer 토큰이 검증되며, 그 결과가 Spotnana UI로 반환됩니다.

파트너 UI가 파트너 서버에 caller의 인증 코드를 요청합니다. 인증 코드가 발급되어 파트너 UI로 전달됩니다.

파트너 UI가 custom redirect URL을 사용해 Spotnana UI에 요청을 보내며, 이때 tmcId 와 authCode 가 파라미터로 포함됩니다.

Spotnana UI가 Spotnana 서버의 POST API를 호출하며, v2/auth/token/companies/<tmcId>(authCode) 엔드포인트를 사용합니다.

• Spotnana 서버가 파트너 서버에 인증 코드를 사용해 사용자의 pid 를 조회합니다.
• 사용자의 pid 가 조회되어 Spotnana 서버로 전달됩니다.

Spotnana 서버에서 access token과 refresh token을 생성해 Spotnana UI로 전달합니다.

• Spotnana UI가 access token과 refresh token을 사용해 Spotnana 서버에 bearer 토큰 발급을 요청합니다.
• bearer 토큰이 생성되어 Spotnana UI로 전달됩니다.

참고: bearer 토큰이 정상적으로 생성되면, 사용자가 인증되어 Spotnana에 접근할 수 있음을 의미합니다.

• 4단계에서 인증이 완료되면, 이후 모든 API 요청에는 bearer 토큰과 orgId, 그리고 tmcId 가 요청 헤더에 포함되어야 합니다.
• 모든 API 요청에서 bearer 토큰이 검증되며, 그 결과가 Spotnana UI로 반환됩니다.

파트너 서버가 Spotnana IdP의 /oauth2/token(clientId,clientSecret) 엔드포인트로 API 요청을 보내 bearer 토큰을 발급받습니다. 새 bearer 토큰은 파트너 서버로 반환됩니다.

• 파트너 서버가 외부 콜백 URL에 API 요청을 보내 사용자를 위한 access token을 발급받습니다.
• 생성된 access token은 Spotnana 서버로 전달됩니다.

• Spotnana 서버가 앞서 동기화된 공개키로 access token의 서명을 검증합니다. 또한 claim_id 를 검증하여 파트너의 신원을 확인합니다.
• access token은 이후 파트너 서버로 전달되어 사용자의 인증에 활용됩니다.