Konfiguracja logowania przez Apple
- Zarejestruj się na https://developer.apple.com/account
Utwórz konto firmowe lub developerskie (zalecane)
a) W przypadku konta firmowego niezbędna będzie weryfikacja firmy numerem DUNS
Numer DUNS można uzyskać pisząc do organizacji, która go przydziela:
https://www.dnb.com/pl-pl/numer-d-u-n-s-wypelnij-formularz.html
b) W przypadku konta developerskiego nie potrzeba tego numeru
- Uiść opłatę w wysokości ok. 500 zł (opłata roczna) - wymaganą przez Apple
- Po zweryfikowaniu konta i uiszczeniu opłaty przejdź do sekcji Certificates, Identifiers & Profiles.
- Kliknij zaznaczony plus, aby dodać nowy identyfikator
Apple wymaga utworzenia najpierw App ID, które służy jako "kontener" do uprawnień, ale sam nie wymusza stworzenia żadnej aplikacji.
Potrzebujemy App ID, aby móc skonfigurować Service ID, które umożliwi nam logowanie przez Apple w Caterings.
Wybierz App ID jako typ identyfikatora
Wybierz App
Dodaj Description, oraz Bundle ID
Są to nazwy wymyślone przez Ciebie, które pomogą Ci zidentyfikować to App ID, będące kontenerem na uprawnienia dla Service ID, które za chwile stworzysz.
Np. dla naszego panelu na panel1.demo.caterings.pl wprowadzono poniższe opisy:
Następnie przewiń w dół do sekcji Capabilities i zaznacz Sign in with Apple i kliknij "Edit"
Po kliknięciu "Edit" wybierz następujące ustawienie i kliknij save.
Przewiń na samą górę strony i kliknij Continue
A następnie "Register"
- Przejdź ponownie do sekcji Certificates, Identifiers & Profiles
Wybierz Service ID jako typ identyfikatora i nadaj mu Description i Identifier, kliknij Continue, oraz Register
Przykładowa nazwa dla panel.demo.caterings.pl:
UWAGA: Description będzie widoczne dla klientów przy logowaniu. Może zawierać spacje.
Przykład:
Upewnij się, że lupa z prawej strony pokazuje Services ID i wybierz utworzony właśnie Service ID
Wybierz Sign in with Apple i Configure
Wyskoczy modal, na którym będą 3 kroki do wykonania
a) Wybierz App ID, utworzone przed chwilą
b) Wprowadź nazwę domeny i swoje subdomeny
UWAGA: Bez "https" na początku i bez i slashy na końcu.
Wprowadź adresy oddzielone przecinkiem.
c) Wprowadź Return Urls
Return url to API panelu klienta + /frontend/auth/apple/ + brand_id (z panelu admina)
Podajemy pełny adres z https.
Jeśli pomimo poniższej instrukcji napotkasz na problemy w znalezieniu API swojego Cateringu i zdobyciu Return URL, skontaktuj się z Supportem Caterings.
Zamawiarka panel1.demo.caterings.pl ma:
Api: api.pl.caterings.pl (instrukcja jak to sprawdzić jest poniżej).
Brand_id: 1 (na panelu admina)
Zatem w naszym przypadku Return Url wygląda następująco:
Jeśli nie wiesz jak sprawdzić API, wejdź na panel klienta swojego cateringu, kliknij gdziekolwiek na stronie prawym klawiszem i wybierz "zbadaj"
Otworzą się narzędzia developerskie, wybierz w nich "Network"
Kliknij np. na diecie "Zobacz menu i opis"
Pojawią się requesty. Po kliknięciu na niektóre requesty, w tym przypadku na order-form i wybraniu zakładki Headers pokaże się URL z API.
Skopiuj to co widać do pierwszego slasha. W przypadku zamawiarki panelu Demo jest to https://api.pl.caterings.pl
Dodajemy do tego '/frontend/auth/apple/1' i finalnie mamy https://api.pl.caterings.pl/frontend/auth/apple/1
Po uzupełnieniu wszystkich tych sekcji kliknij Next
Następnie potwierdź konfigurację
Na widoku Service ID kliknij Continue
A potem Save
- Wejdź na Certificates, Identifiers & Profiles i wybierz Keys
Naciśnij ikonę plusa, aby dodać nowy Key
Nazwij go jak chcesz np logowanie, zaznacz Sign in with Apple i kliknij Configure
Wybierz swoje App ID i kliknij Save
Następnie kliknij Continue
Kliknij Register
Kliknij Download, ale zapisz sobie również Key ID, będzie potrzebne w kolejnym kroku.
Po pobraniu klucza kliknij Done i przejdź do Panelu Admina do Konfiguruj markę -> Opcje logowania i zaznacz Logowanie przez Apple
Wprowadź swoje dane z Apple Developer:
Apple Team ID:
- Jest widoczny w prawym górnym rogu ekranu (np. ABCD123456), jeśli nie widzisz:
- Zaloguj się do Apple Developer Account.
- Przejdź do zakładki Membership (Członkostwo).
- Znajdziesz tam Team ID
Apple Client ID - inaczej Service ID, to co potrzebowaliśmy ustawić, aby móc wygenerować KEY
Apple Key File ID - ID pobranego klucza
Apple KEY File Content - treść pobranego na komputer klucza
Następnie zapisz zmiany, wejdź w Konfiguruj markę -> Formularz zamówienia i wyczyść Cache zielonym przyciskiem.
Po odświeżeniu Panelu Klienta, pojawi się opcja logowania przez Apple
Kliknięcie przycisku Apple przekieruje na:
Co pozwoli się zalogować i wrócić na stronę zamawiarki.
Dodawanie logowania na kilka marek
- Service ID: Każda marka potrzebuje osobnego Service ID
- App ID: Może być ten sam dla różnych marek, jeśli aplikacje są zarejestrowane pod jednym kontem deweloperskim.
- Key ID i Key Content (klucz prywatny .p8) mogą być współdzielone, ponieważ są powiązane z Apple Team ID, a nie bezpośrednio z Service ID.