• Το Spotnana UI στέλνει αίτημα API στον διακομιστή Spotnana για να λάβει τις ρυθμίσεις ταυτοποίησης του χρήστη. Το αίτημα περιλαμβάνει τα διαπιστευτήρια εισόδου του χρήστη.
• Η απάντηση περιέχει τα tmcId, orgIdκαι το authProviderTypeτου χρήστη.

• Το Spotnana UI στέλνει αίτημα API στο Spotnana IdP χρησιμοποιώντας το clientId, το email και τον κωδικό πρόσβασης. Το Spotnana IdP δημιουργεί νέο bearer token και το επιστρέφει στο Spotnana UI.
• Με αυτό το βήμα ολοκληρώνεται η ταυτοποίηση του χρήστη.

• Αφού ο χρήστης ταυτοποιηθεί στο βήμα 2, όλα τα επόμενα αιτήματα API πρέπει να περιλαμβάνουν το bearer token, το orgIdκαι το tmcId στα headers του αιτήματος.
• Το bearer token ελέγχεται σε όλα τα εισερχόμενα αιτήματα API και η απάντηση αποστέλλεται πίσω στο Spotnana UI.

• Το Spotnana UI στέλνει αίτημα API στον διακομιστή Spotnana για να λάβει τις ρυθμίσεις ταυτοποίησης του χρήστη. Το αίτημα περιλαμβάνει τα διαπιστευτήρια εισόδου του χρήστη.
• Η απάντηση περιέχει τα tmcId, orgIdκαι το authProviderTypeτου χρήστη.

Ο χρήστης εισάγει νέο κωδικό πρόσβασης και επιλέγει Επόμενο.

• Το Spotnana UI στέλνει αίτημα API στο Spotnana IdP για εγγραφή του χρήστη μαζί με το clientId, το email και τον νέο κωδικό πρόσβασης.
• Αφού καταχωρηθούν τα στοιχεία, αποστέλλεται ένας προσωρινός κωδικός (OTP) στο email του χρήστη.

• Ο χρήστης εισάγει τον OTP στο Spotnana UI και επιλέγει Επιβεβαίωση.
• Το Spotnana UI στέλνει αίτημα στο Spotnana IdP για επιβεβαίωση του OTP και δημιουργία bearer token για είσοδο.
• Το bearer token δημιουργείται και επιστρέφεται στο Spotnana UI. Αυτό σημαίνει ότι ο χρήστης ταυτοποιήθηκε επιτυχώς και μπορεί να έχει πρόσβαση στην πλατφόρμα Spotnana με το bearer token.

• Αφού ο χρήστης ταυτοποιηθεί στο βήμα 3, όλα τα επόμενα αιτήματα API πρέπει να περιλαμβάνουν το bearer token, το orgIdκαι το tmcId στα headers του αιτήματος.
• Το bearer token ελέγχεται σε όλα τα εισερχόμενα αιτήματα API και η απάντηση αποστέλλεται πίσω στο Spotnana UI.

• Το Spotnana UI στέλνει αίτημα API στον διακομιστή Spotnana για να λάβει τις ρυθμίσεις ταυτοποίησης του χρήστη. Το αίτημα περιλαμβάνει τα διαπιστευτήρια εισόδου του χρήστη.
• Η απάντηση περιέχει τα tmcId, orgIdκαι το authProviderTypeτου χρήστη.

Το Spotnana UI ανακατευθύνει το αίτημα στο Spotnana IdP.

Το Spotnana IdP ανακατευθύνει το αίτημα στον IdP του συνεργάτη. Έτσι ξεκινά η ταυτοποίηση μέσω IdP για τον χρήστη.

Σημείωση: Σε κάθε ανακατεύθυνση, επιστρέφεται κωδικός κατάστασης 302 για να δηλωθεί ότι το αίτημα μεταφέρθηκε σε διαφορετική διεύθυνση.

Δημιουργείται σύνδεση μεταξύ του Spotnana IdP και του IdP του συνεργάτη, ώστε να διασφαλιστεί ότι ο χρήστης ταυτοποιείται από τον IdP του συνεργάτη.

Σημείωση: Κατά τη σύνδεση αυτή, το Spotnana IdP αποστέλλει το clientId και το clientSecret ως δεδομένα τύπου form URL-encoded μέσω API στον IdP του συνεργάτη. Αν οι διακομιστές IdP δεν υποστηρίζουν αυτή τη μορφή, ο διακομιστής Spotnana μπορεί να λειτουργήσει ως διαμεσολαβητής και να μετατρέψει τα δεδομένα στη μορφή που απαιτεί ο IdP του συνεργάτη.

Ο IdP του συνεργάτη ταυτοποιεί επιτυχώς τον χρήστη.

Σημείωση: Μετά από αυτό το βήμα, το προφίλ του χρήστη πρέπει να περάσει από έλεγχο του bearer token.

Μετά την επιτυχή ταυτοποίηση, η απάντηση από τον IdP του συνεργάτη αποστέλλεται στο Spotnana IdP.

Το Spotnana IdP δημιουργεί έναν μοναδικό κωδικό για το προφίλ του χρήστη και τον στέλνει στο Spotnana UI.

• Το Spotnana UI στέλνει αίτημα API στο Spotnana IdP χρησιμοποιώντας το clientID και τον κωδικό που έλαβε στο βήμα 5(β).
• Το Spotnana IdP δημιουργεί νέο bearer token και το επιστρέφει στο Spotnana UI.

Σημείωση: Η επιτυχής δημιουργία bearer token σημαίνει ότι ο χρήστης έχει ταυτοποιηθεί και μπορεί να έχει πρόσβαση στη Spotnana.

• Αφού ο χρήστης ταυτοποιηθεί στο βήμα 6, όλα τα επόμενα αιτήματα API πρέπει να περιλαμβάνουν το bearer token, το orgIdκαι το tmcId στα headers του αιτήματος.
• Το bearer token ελέγχεται σε όλα τα εισερχόμενα αιτήματα API και η απάντηση αποστέλλεται πίσω στο Spotnana UI.

Ο χρήστης API πραγματοποιεί μια κλήση POST στο endpoint get-auth-token(clientId,clientSecret) του διακομιστή Spotnana για να δημιουργήσει και να λάβει προσωρινό bearer token.

Παράδειγμα εντολής cURL για το endpoint 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 καλεί τη μέθοδο getToken(clientId,clientSecret) στο Spotnana IdP, η οποία δημιουργεί προσωρινό bearerToken και το επιστρέφει στον διακομιστή Spotnana.
• Ο διακομιστής Spotnana στέλνει αυτό το bearer token ως απάντηση JSON στον χρήστη API.

Το Partner UI στέλνει αίτημα API στον διακομιστή συνεργάτη για να λάβει το OAuth token, ξεκινώντας τα επόμενα βήματα της ροής ταυτοποίησης.

Ο διακομιστής συνεργάτη καλεί τον διακομιστή Spotnana χρησιμοποιώντας τα διαπιστευτήρια του χρήστη και το subject token ως παραμέτρους. Ο διακομιστής Spotnana ελέγχει αν το αίτημα προέρχεται από API/μηχανή.

• Ο διακομιστής Spotnana καλεί τον διακομιστή συνεργάτη για να λάβει το email του subject (δηλαδή του caller).
• Το email ανακτάται και επιστρέφεται στον διακομιστή Spotnana, ώστε να γίνει ταυτοποίηση του χρήστη.

• Η απάντηση στο αίτημα API του βήματος 1 αποστέλλεται από τον διακομιστή Spotnana στον διακομιστή συνεργάτη και περιέχει το access token και το refresh token.
• Αυτά τα στοιχεία προωθούνται στη συνέχεια στο Partner UI.

Το Partner UI στέλνει το διακριτικό στο Spotnana UI μέσω post message με τύπο type=TOKEN_EXCHANGE_RESPONSE.

• Το Spotnana UI στέλνει αίτημα API στον διακομιστή Spotnana για να δημιουργήσει και να λάβει νέο bearer token.
• Το bearer token δημιουργείται από τον διακομιστή Spotnana και επιστρέφεται στο Spotnana UI.

Σημείωση: Η επιτυχής δημιουργία bearer token σημαίνει ότι ο χρήστης έχει ταυτοποιηθεί και μπορεί να έχει πρόσβαση στη Spotnana.

• Αφού ο χρήστης ταυτοποιηθεί στο βήμα 3, όλα τα επόμενα αιτήματα API πρέπει να περιλαμβάνουν το bearer token, το orgIdκαι το tmcId στα headers του αιτήματος.
• Το bearer token ελέγχεται σε όλα τα εισερχόμενα αιτήματα API και η απάντηση αποστέλλεται πίσω στο Spotnana UI.

Το Partner UI καλεί τον διακομιστή συνεργάτη για να λάβει τον κωδικό εξουσιοδότησης για τον caller που συνδέεται. Ο κωδικός εξουσιοδότησης επιστρέφεται στο Partner UI.

Το Partner UI στέλνει αίτημα στο Spotnana UI χρησιμοποιώντας προσαρμοσμένο redirect URL που περιέχει τα tmcId και authCode ως παραμέτρους.

Το Spotnana UI πραγματοποιεί κλήση POST API στον διακομιστή Spotnana χρησιμοποιώντας το endpoint v2/auth/token/companies/<tmcId>(authCode) .

• Ο διακομιστής Spotnana στέλνει αίτημα στον διακομιστή συνεργάτη για να λάβει το pid του χρήστη με χρήση του auth code.
• Το pid του χρήστη ανακτάται και αποστέλλεται στον διακομιστή Spotnana.

Το access token και το refresh token δημιουργούνται από τον διακομιστή Spotnana και αποστέλλονται στο Spotnana UI.

• Το Spotnana UI στέλνει αίτημα στον διακομιστή Spotnana χρησιμοποιώντας το access token και το refresh token για να δημιουργήσει και να λάβει bearer token για πρόσβαση.
• Το bearer token δημιουργείται και αποστέλλεται στο Spotnana UI.

Σημείωση: Η επιτυχής δημιουργία bearer token σημαίνει ότι ο χρήστης έχει ταυτοποιηθεί και μπορεί να έχει πρόσβαση στη Spotnana.

• Αφού ο χρήστης ταυτοποιηθεί στο βήμα 4, όλα τα επόμενα αιτήματα API πρέπει να περιλαμβάνουν το bearer token, το orgIdκαι το tmcId στα headers του αιτήματος.
• Το bearer token ελέγχεται σε όλα τα εισερχόμενα αιτήματα API και η απάντηση αποστέλλεται πίσω στο Spotnana UI.

Ο διακομιστής συνεργάτη στέλνει αίτημα API στο /oauth2/token(clientId,clientSecret) του Spotnana IdP για να δημιουργήσει bearer token. Το νέο bearer token επιστρέφεται στον διακομιστή συνεργάτη.

• Ο διακομιστής συνεργάτη στέλνει αίτημα API σε εξωτερική διεύθυνση (callback URL) για να δημιουργήσει access token για τον χρήστη.
• Το access token δημιουργείται και αποστέλλεται στον διακομιστή Spotnana.

• Ο διακομιστής Spotnana επαληθεύει την υπογραφή του access token χρησιμοποιώντας τα δημόσια κλειδιά που συγχρονίστηκαν προηγουμένως. Ελέγχει επίσης το claim_id για να επιβεβαιώσει την ταυτότητα του συνεργάτη.
• Το access token αποστέλλεται στον διακομιστή συνεργάτη για να γίνει ταυτοποίηση του χρήστη.