🥇Как в Parallels завладяхме Sign In with Apple

Мисля, че след WWDC 2019 много хора вече са чули за Sign In with Apple (кратко SIWA). В материала ще споделя с какви конкретно подводни камъни се сблъскахме при интегрирането на тази функция в нашия лицензионен портал. Тази статия не е напълно подходяща за тези, които просто искат да се запознаят с SIWA (за тях съм предоставил редица запознавателни линкове в края на текста). В този материал вероятно много ще намерят отговори на въпросите, които могат да възникнат при интегрирането на новата услуга от Apple.

Apple не позволява кастомизирани пренасочвания

Същност, все още не виждам отговор на този въпрос в разработчиците форуми. Става въпрос за следното: ако искате да използвате SIWA JS API, т.е. да не работите през нативния SDK поради отсъствието на такъв по различни причини (не macOS/iOS или стара версия на тези системи), то ви е необходим свой публичен портал, иначе не може. Защото на WWDR портала трябва да регистрирате и потвърдите, че сте собственик на вашия домейн и само на него можете да свържете допустимите от Apple пренасочвания:

Какво да правим, ако имате желание да перехванете пренасочването в приложението? Решихме този проблем много просто: създадохме на нашия портал списък с допустими пренасочвания за нашите приложения, които те искат преди да покажат авторизационната страница на SIWA. И просто правим пренасочване от портала към приложението с данните, получени от Apple. Просто и ефикасно.

Проблеми с e-mail

Нека разгледаме как решавахме проблемите с e-mail на потребителя. Първо, няма никакъв REST API, който да позволява получаването на тази информация от бекенда — само клиентът получава данните и може да ги предаде заедно с авторизационния код.

На второ място, информацията за името и e-mail на потребителя се предава само веднъж, при първоначалното влизане на потребителя в приложението чрез Apple, когато потребителят избира опциите за споделяне на личните си данни.

Тези проблеми сами по себе си не са критични, ако връзката със социалния профил е била успешно създадена в портала — идентификаторът на потребителя е един и същ и е свързан с Team ID — т.е. той е един за всички приложения на вашия екип, интегрирани с SIWA. Но ако входът е извършен през Apple, а след това е възникнала грешка, и връзката в портала не е била създадена, единственият вариант е да насочите потребителя към appleid.apple.com, да прекъснете връзката с приложението и да опитате отново. Всъщност, проблемът се решава с написването на съответна статия във KB и предоставянето на връзка към нея.

Следващият, по-неприятен проблем е свързан с новата концепция на Apple за прокси имейл. В нашия случай, ако потребителят вече е бил на лицензионния портал с истинския си имейл и при първия вход през Apple избере опцията за скриване на имейла, се регистрира нов акаунт с този прокси имейл, в който очевидно няма лицензии, което поставя крайния потребител в затруднено положение.

Решението на този проблем е доста просто: тъй като идентификаторът на потребителя е един и същ в SIWA и не зависи от избраните опции/приложения за вход, ние просто с помощта на специален скрипт позволяваме да се прехвърли тази връзка с Apple към друг акаунт с истинския имейл на потребителя и по този начин да се "възстановят" покупките. След тази процедура потребителят започва да влиза в друг акаунт на портала през SIWA и всичко при него работи правилно.

При вход през уеб портала няма иконка на приложението.

За решаването на друг проблем се обърнахме за разяснение към представители на Apple и споделяме получените знания:

https://forums.developer.apple.com/thread/123054

Т.е. смисълът е следният: начело на SIWA групата може да стои само macOS/iOS приложение, в което вече се добавят нужните service ID на порталите. Следователно, за да се показва иконката на главното приложение, трябва да са публикувани в App Store версии с медии, преминали проверка в Apple. Иконката ще бъде взета оттам.

Следователно, ако имате само портал и приложения от App Store няма, ще нямате красива иконка, но с името на приложението можете да се справите — при отсъствие на медии на главното приложение, тази информация се взима от Description service ID:

Броят на елементите в групата SIWA е ограничен до 5

В момента няма решение на този проблем, освен да използвате множество групи. Ако ви липсват 6 идентификатора: 1 основно приложение и 5 зависими, при опит за регистрация на следващото ще видите следното съобщение:

Създадохме групи за нашия лицензионен портал и за всяко от приложенията, които работят с този портал. Относно ограничението на слотовете вече подадохме радар в Apple и очакваме техния отговор.