• Spotnana UI 會發送 API 請求到 Spotnana server，取得該使用者的驗證設定資訊。這個請求會包含使用者的登入憑證。
• 回應內容會帶回使用者的 tmcId、 orgId和 authProviderType。

• Spotnana UI 會用 clientId、email 和密碼發送 API 請求到 Spotnana IdP。Spotnana IdP 會產生新的 bearer token 並回傳給 Spotnana UI。
• 這個步驟就完成了使用者的驗證。

• 使用者驗證通過後，之後所有的 API 請求都必須在 request header 帶上 bearer token、 orgId和 tmcId 。
• 所有 API 請求收到的 bearer token 都會被驗證，驗證通過後才會回應給 Spotnana UI。

• Spotnana UI 會發送 API 請求到 Spotnana server，取得該使用者的驗證設定資訊。這個請求會包含使用者的登入憑證。
• 回應內容會帶回使用者的 tmcId、 orgId和 authProviderType。

使用者輸入新密碼後，點選 下一步。

• Spotnana UI 會發送 API 請求到 Spotnana IdP，註冊使用者，並帶上 clientId、email 和新密碼。
• 註冊完成後，系統會寄送一次性驗證碼（OTP）到使用者信箱。

• 使用者在 Spotnana UI 輸入 OTP，然後點選 驗證。
• Spotnana UI 會發送請求到 Spotnana IdP，驗證 OTP 並產生登入用的 bearer token。
• bearer token 產生後會回傳給 Spotnana UI，代表使用者已經成功驗證，可以用 bearer token 存取 Spotnana 平台。

• 使用者驗證通過後，之後所有的 API 請求都必須在 request header 帶上 bearer token、 orgId和 tmcId 。
• 所有 API 請求收到的 bearer token 都會被驗證，驗證通過後才會回應給 Spotnana UI。

• Spotnana UI 會發送 API 請求到 Spotnana server，取得該使用者的驗證設定資訊。這個請求會包含使用者的登入憑證。
• 回應內容會帶回使用者的 tmcId、 orgId和 authProviderType。

Spotnana UI 會將請求導向 Spotnana IdP。

Spotnana IdP 會再將請求導向合作夥伴的 IdP，正式啟動 IdP 驗證流程。

注意： 每次重新導向時，系統會回傳 302 狀態碼，表示請求已被導向到其他網址。

Spotnana IdP 和合作夥伴 IdP 之間會建立連線，確保使用者由合作夥伴 IdP 驗證通過。

注意： 在這個連線過程中，Spotnana IdP 會用 API call 方式，把 clientId 和 clientSecret 以 form URL-encoded 格式傳給合作夥伴 IdP。如果對方 IdP 伺服器不支援這個格式，Spotnana server 可以當作 proxy，將資料轉換成合作夥伴 IdP 能接受的格式。

合作夥伴 IdP 驗證使用者成功。

注意： 這一步完成後，使用者資料還需要經過 bearer token 驗證。

合作夥伴 IdP 驗證成功後，會把回應傳給 Spotnana IdP。

Spotnana IdP 會針對該使用者產生一組唯一的 code，並傳給 Spotnana UI。

• Spotnana UI 會用 clientID 和步驟 5(b) 拿到的 code 發送 API 請求給 Spotnana IdP。
• Spotnana IdP 會產生新的 bearer token 並回傳給 Spotnana UI。

注意： 成功產生 bearer token 就代表使用者已經驗證通過，可以存取 Spotnana。

• 使用者驗證通過後，之後所有的 API 請求都必須在 request header 帶上 bearer token、 orgId和 tmcId 。
• 所有 API 請求收到的 bearer token 都會被驗證，驗證通過後才會回應給 Spotnana UI。

API 使用者發送 POST 請求到 get-auth-token(clientId,clientSecret) 這個 Spotnana server 的 API 端點，來產生並取得暫時性的 bearer token。

下面提供一個 cURL 範例，說明如何呼叫 get-auth-token 端點：

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

注意： 請將 clientId 和 clientSecret 換成你從 Spotnana 拿到的憑證。 

• Spotnana server 會呼叫 getToken(clientId,clientSecret) 這個 Spotnana IdP 的方法，產生暫時性的 bearerToken ，並回傳給 Spotnana server。
• Spotnana server 會把這個 bearer token 用 JSON 格式回傳給 API 使用者。

合作夥伴 UI 會發送 API 請求給合作夥伴 server，取得 OAuth token，啟動後續驗證流程。

合作夥伴 server 會帶著使用者憑證和 subject token，呼叫 Spotnana server。Spotnana server 會檢查這個請求是不是來自 API/機器用戶。

• Spotnana server 會呼叫合作夥伴 server，取得 subject（也就是 caller）的 email。
• 合作夥伴 server 會回傳 email，Spotnana server 會用這個 email 來識別使用者。

• Spotnana server 會把 access token 和 refresh token 回傳給合作夥伴 server。
• 這些資訊會再傳回合作夥伴 UI。

合作夥伴 UI 會用 post message，把 token 傳給 Spotnana UI，內容帶上 type=TOKEN_EXCHANGE_RESPONSE.

• Spotnana UI 會發送 API 請求到 Spotnana server，產生並取得新的 bearer token。
• Spotnana server 會產生 bearer token 並回傳給 Spotnana UI。

注意： 成功產生 bearer token 就代表使用者已經驗證通過，可以存取 Spotnana。

• 使用者驗證通過後，之後所有的 API 請求都必須在 request header 帶上 bearer token、 orgId和 tmcId 。
• 所有 API 請求收到的 bearer token 都會被驗證，驗證通過後才會回應給 Spotnana UI。

合作夥伴 UI 會呼叫合作夥伴 server，取得 caller 的授權碼，然後回傳給合作夥伴 UI。

合作夥伴 UI 會用帶有 tmcId 和 authCode 的自訂 redirect URL，發送請求給 Spotnana UI。

Spotnana UI 會發送 POST API 請求到 Spotnana server，使用 v2/auth/token/companies/<tmcId>(authCode) 這個 API 端點。

• Spotnana server 會用授權碼跟合作夥伴 server 取得使用者的 pid 。
• 使用者的 pid 會回傳給 Spotnana server。

Spotnana server 會產生 access token 和 refresh token，並回傳給 Spotnana UI。

• Spotnana UI 會用 access token 和 refresh token 發送請求到 Spotnana server，產生 bearer token。
• Spotnana UI 會收到產生好的 bearer token。

注意： 成功產生 bearer token 就代表使用者已經驗證通過，可以存取 Spotnana。

• 使用者驗證通過後，之後所有的 API 請求都必須在 request header 帶上 bearer token、 orgId和 tmcId 。
• 所有 API 請求收到的 bearer token 都會被驗證，驗證通過後才會回應給 Spotnana UI。

合作夥伴 server 會發送 API 請求到 /oauth2/token(clientId,clientSecret) 這個 Spotnana IdP 端點，產生 bearer token，然後回傳給合作夥伴 server。

• 合作夥伴 server 會發送 API 請求到第三方 callback URL，為使用者產生 access token。
• access token 產生後，會傳給 Spotnana server。

• Spotnana server 會用先前同步的公鑰驗證 access token 的簽章，同時也會驗證 claim_id ，確認合作夥伴身分。
• access token 驗證通過後，會傳給合作夥伴 server，完成使用者驗證。