Οδηγός βήμα προς βήμα για τη σύνδεση με Google και Apple

Ο οδηγός απευθύνεται στον διαχειριστή ενός λογαριασμού white-label. Σας δείχνει τι να δημιουργήσετε στη Google και στην Apple, ώστε οι πελάτες σας να χρησιμοποιούν το Συνέχεια με Google και το Συνέχεια με Apple στο δικό σας domain. Κάθε μέρος το κάνετε μία φορά. Πηγαίνετε στο Google ή στο Apple παρακάτω και τελειώνετε στις Ρυθμίσεις > Σύνδεση στο domain σας.

Και οι δύο πάροχοι ζητούν από εσάς δύο διευθύνσεις. Οι Ρυθμίσεις > Σύνδεση στο domain σας τις δείχνουν για το domain σας, με κουμπί αντιγραφής η καθεμία: αντιγράψτε τες πάντα από εκεί και επικολλήστε τες, ποτέ μην τις πληκτρολογείτε, γιατί ένας λάθος χαρακτήρας αρκεί για να απορρίψει ο πάροχος τη σύνδεση. Έχουν αυτή τη μορφή, μόνο για προσανατολισμό:

• JavaScript origin: το domain σας με https μπροστά και τίποτα μετά (χωρίς διαδρομή, χωρίς τελική κάθετο)
• Διεύθυνση επιστροφής Google (redirect URI): <your domain>/gorouter/ai/wl/oauth/google/callback
• Διεύθυνση επιστροφής Apple (Return URL): <your domain>/gorouter/ai/wl/oauth/apple/callback

Η Google και η Apple αλλάζουν κατά καιρούς τα ονόματα των μενού τους. Αν μια ετικέτα παρακάτω δεν είναι ακριβώς αυτό που βλέπετε, ψάξτε την πιο κοντινή: τα βήματα μένουν ίδια.

Google#

Χρειάζεστε έναν λογαριασμό Google που ελέγχετε εσείς. Η βασική σύνδεση που χρησιμοποιείται ζητά μόνο το όνομα, τη διεύθυνση email και τη φωτογραφία προφίλ του πελάτη (τα scopes openid, email και profile), και τίποτε άλλο.

1. Συνδεθείτε και διαλέξτε project#

1. Ανοίξτε το Google Cloud Console (console.cloud.google.com) και συνδεθείτε με τον λογαριασμό Google σας.
2. Στον επιλογέα project στην επάνω γραμμή διαλέξτε ένα project, ή πατήστε New project, δώστε όνομα και δημιουργήστε το. Βεβαιωθείτε ότι αυτό το project είναι το επιλεγμένο πριν συνεχίσετε.

2. Ρυθμίστε την οθόνη συγκατάθεσης#

Είναι η οθόνη που η Google δείχνει στους πελάτες σας. Βρίσκεται στο Google Auth Platform.

1. Ανοίξτε το Google Auth Platform και πατήστε Get started.
2. App information: γράψτε το όνομα εφαρμογής που θα αναγνωρίζουν οι πελάτες σας (τη δική σας επωνυμία, όχι τη δική μας) και μια διεύθυνση email υποστήριξης.
3. Audience: διαλέξτε External. Το Internal επιτρέπει σύνδεση μόνο σε λογαριασμούς του δικού σας οργανισμού Google Workspace, κάτι που δεν θέλετε για πελάτες.
4. Contact information: γράψτε μια διεύθυνση email όπου μπορεί να σας γράψει η Google για το project.
5. Αποδεχτείτε την πολιτική δεδομένων χρήστη και πατήστε Create.

3. Χρήστες δοκιμής ή δημοσίευση της εφαρμογής#

Μια νέα εφαρμογή ξεκινά σε κατάσταση Testing. Σε αυτήν η Google περιορίζει τη σύνδεση στις διευθύνσεις που έχετε καταχωρίσει, έως 100.

• Για να τις καταχωρίσετε, ανοίξτε το Audience, βρείτε το Test users και προσθέστε κάθε διεύθυνση Google που θα συνδεθεί. Κάντε το για τον εαυτό σας και για όποιον δοκιμάζει τη σύνδεση πριν δημοσιεύσετε.
• Για να μπορεί να συνδεθεί κάθε πελάτης, δημοσιεύστε την εφαρμογή: στο Audience αλλάξτε την κατάσταση δημοσίευσης από Testing σε In production με το κουμπί δημοσίευσης. Επειδή αυτή η σύνδεση χρησιμοποιεί μόνο τα βασικά scopes openid, email και profile, η Google δεν απαιτεί έλεγχο των scopes και δεν δείχνει στους πελάτες προειδοποίηση «μη επαληθευμένη εφαρμογή». Η Google μπορεί ακόμη να ζητήσει να επαληθεύσετε την επωνυμία σας πριν δείξει το όνομα και το λογότυπο της εφαρμογής στην οθόνη συγκατάθεσης: το Verification Center στο Google Auth Platform σας το λέει.

4. Δημιουργήστε το client#

1. Στο Google Auth Platform ανοίξτε το Clients και πατήστε Create client.
2. Ως Application type διαλέξτε Web application και δώστε ένα όνομα.
3. Στα Authorized JavaScript origins πατήστε Add URI και επικολλήστε το JavaScript origin που αντιγράψατε από τις Ρυθμίσεις > Σύνδεση στο domain σας.
4. Στα Authorized redirect URIs πατήστε Add URI και επικολλήστε τη διεύθυνση επιστροφής Google που αντιγράψατε από το ίδιο σημείο.
5. Πατήστε Create.

5. Αντιγράψτε το Client ID και το Client secret#

Η Google δείχνει τώρα το Client ID και το Client secret. Αντιγράψτε και τα δύο αμέσως. Σε ένα νέο client η Google δείχνει το secret μόνο αυτή τη στιγμή και μετά κρατά μόνο τους τέσσερις τελευταίους χαρακτήρες του. Αν το χάσετε, δημιουργήστε νέο secret από τη σελίδα του client.

6. Τελειώστε στις ρυθμίσεις#

Στις Ρυθμίσεις > Σύνδεση στο domain σας επικολλήστε το Client ID και το Client secret στην ενότητα Google, ενεργοποιήστε το Google και αποθηκεύστε.

Αν η Google το απορρίψει#

• Η κονσόλα δεν δέχεται τη διεύθυνση επιστροφής εξαιτίας του domain: ανοίξτε το Branding, βρείτε το Authorized domains και προσθέστε το domain σας, και μετά προσθέστε ξανά τη διεύθυνση.
• redirect_uri_mismatch αμέσως μετά τη δημιουργία του client: η Google μπορεί να χρειαστεί από λίγα λεπτά έως και αρκετές ώρες για να εφαρμόσει μια αλλαγή. Περιμένετε και δοκιμάστε ξανά. Αν επιμένει, συγκρίνετε χαρακτήρα προς χαρακτήρα τη διεύθυνση στο client με αυτή στις ρυθμίσεις.
• Η πρόσβαση μπλοκάρεται μόνο για ένα άτομο: αν η εφαρμογή είναι ακόμη σε Testing, προσθέστε τη διεύθυνσή του στο Test users, ή δημοσιεύστε την εφαρμογή.

Apple#

Χρειάζεστε επί πληρωμή συνδρομή στο Apple Developer Program: χωρίς αυτήν η Apple δεν σας αφήνει να δημιουργήσετε αυτά τα στοιχεία. Όλα τα βήματα παρακάτω γίνονται στον λογαριασμό Apple Developer (developer.apple.com/account), στο Certificates, Identifiers & Profiles.

1. Ένα App ID με Sign in with Apple#

Η Apple συνδέει έναν ιστότοπο με ένα App ID. Αν ο λογαριασμός σας έχει ήδη App ID με ενεργό το Sign in with Apple, χρησιμοποιήστε το και πηγαίνετε στο επόμενο βήμα. Αλλιώς:

1. Ανοίξτε το Identifiers και πατήστε το κουμπί προσθήκης (+).
2. Διαλέξτε App IDs, μετά τον τύπο App, και συνεχίστε.
3. Γράψτε μια περιγραφή και ένα bundle ID της επιλογής σας, για παράδειγμα της μορφής com.yourcompany.signin.
4. Στη λίστα των capabilities τσεκάρετε το Sign in with Apple, μετά συνεχίστε και καταχωρίστε.

2. Δημιουργήστε το Services ID#

1. Στο Identifiers πατήστε το κουμπί προσθήκης (+), διαλέξτε Services IDs και συνεχίστε.
2. Γράψτε μια περιγραφή και ένα αναγνωριστικό της επιλογής σας, για παράδειγμα com.yourcompany.signin.web. Αυτό το αναγνωριστικό είναι το Services ID σας: σημειώστε το.
3. Συνεχίστε και καταχωρίστε, μετά ανοίξτε το νέο Services ID από τη λίστα.
4. Τσεκάρετε το Sign in with Apple και πατήστε Configure.
5. Ως Primary App ID διαλέξτε το App ID του προηγούμενου βήματος.
6. Στα website URLs προσθέστε το domain σας στο Domains and Subdomains, χωρίς το πρόθεμα https, για παράδειγμα app.yourcompany.com.
7. Στο Return URLs επικολλήστε τη διεύθυνση επιστροφής Apple που αντιγράψατε από τις Ρυθμίσεις > Σύνδεση στο domain σας.
8. Πατήστε Done, μετά Continue, μετά Save.

3. Δημιουργήστε το κλειδί#

1. Ανοίξτε το Keys και πατήστε το κουμπί προσθήκης (+).
2. Γράψτε ένα όνομα κλειδιού και τσεκάρετε το Sign in with Apple, μετά πατήστε Configure δίπλα του.
3. Διαλέξτε το ίδιο primary App ID και αποθηκεύστε.
4. Συνεχίστε και καταχωρίστε το κλειδί.
5. Πατήστε Download και κρατήστε το αρχείο, που τελειώνει σε .p8. Η Apple σας αφήνει να το κατεβάσετε μόνο μία φορά. Ένα primary App ID μπορεί να έχει το πολύ δύο κλειδιά.
6. Σημειώστε το Key ID που φαίνεται για το κλειδί.

4. Βρείτε το Team ID#

Ανοίξτε το Membership details στον λογαριασμό σας developer. Εκεί αναγράφεται το Team ID, δέκα χαρακτήρες.

5. Τελειώστε στις ρυθμίσεις#

Στις Ρυθμίσεις > Σύνδεση στο domain σας συμπληρώστε στην ενότητα Apple το Services ID, το Team ID και το Key ID, ανεβάστε το αρχείο .p8, ενεργοποιήστε το Apple και αποθηκεύστε.

Καλό είναι να ξέρετε#

• Η Apple στέλνει το όνομα του πελάτη μόνο την πρώτη φορά που συνδέεται, και όχι ξανά μετά.
• Ο πελάτης μπορεί να επιλέξει να κρύψει το email του. Τότε η Apple δίνει μια ιδιωτική διεύθυνση προώθησης, που προωθεί στην πραγματική.
• Για να φτάνουν τα email σας σε αυτές τις διευθύνσεις προώθησης, καταχωρίστε το domain ή τη διεύθυνση από την οποία στέλνετε στο Sign in with Apple for Email Communication: στο Certificates, Identifiers & Profiles ανοίξτε το Services, πατήστε Configure δίπλα του και προσθέστε την στο Email Sources. Δημοσιεύστε επίσης ένα record SPF για εκείνο το domain, όπως ζητά η Apple.
• Αν η Apple απορρίψει τη σύνδεση, ελέγξτε ότι το domain και η διεύθυνση επιστροφής στο Services ID είναι ακριβώς αυτά που δείχνουν οι ρυθμίσεις, και ότι το κλειδί δεν έχει ανακληθεί.

Όταν τελειώσετε#

Ενεργοποιήστε έναν τρόπο μόνο αφού συμπληρωθούν τα πεδία του, και αποθηκεύστε. Δοκιμάστε τον σε ιδιωτικό παράθυρο browser στο δικό σας domain. Η σύντομη επισκόπηση της δυνατότητας βρίσκεται στο άρθρο Σύνδεση στο domain σας με Google, Apple ή κωδικό στο email.