הטמעת הרשאת Apple ID באתר

1. Редирект пользователя: GET https://appleid.apple.com/auth/authorize
   ?client_id=com.example.web
   &redirect_uri=https://example.com/auth/apple/callback
   &response_type=code id_token
   &response_mode=form_post
   &scope=name email
   &state=<random_string>
   &nonce=<random_nonce>
2. Apple делает POST на redirect_uri с:
   - code
   - id_token
   - state
   - user (JSON с именем — только при первом входе!)

חשוב: use Lcobucci\JWT\Configuration; use Lcobucci\JWT\Signer\Ecdsa\Sha256; use Lcobucci\JWT\Signer\Key\InMemory; function generateAppleClientSecret(): string { $config = Configuration::forAsymmetricSigner( new Sha256(), InMemory::file(storage_path('keys/apple_auth.p8')), InMemory::empty() ); return $config->builder() ->issuedBy(config('services.apple.team_id')) // iss: Team ID ->permittedFor('https://appleid.apple.com') // aud ->relatedTo(config('services.apple.client_id')) // sub: Services ID ->issuedAt(new \DateTimeImmutable()) ->expiresAt(new \DateTimeImmutable('+6 months')) ->withHeader('kid', config('services.apple.key_id')) ->getToken($config->signer(), $config->signingKey()) ->toString(); } —Apple שולחת POST, לא GET. כתובת ה-redirect חייבת לקבל POST.

Apple OAuth מורכב פי 2-3 ליישום אך נותן גישה לקהל מכשירי iOS. הניסיון מראה ששיעור ההמרה של התחברות דרך Apple ID גבוה ב-25-30% בקרב משתמשי Apple.

טיפול ב-Callback ואימות id_token

public function handleCallback(Request $request): RedirectResponse {
    // Верификация state
    abort_unless($request->state === session('apple_state'), 422);

    // Декодирование id_token (без верификации подписи пока)
    $idToken = $this->decodeIdToken($request->id_token);

    // user приходит только при первом входе
    $appleUser = $request->has('user') ? json_decode($request->user, true) : null;

    $user = User::updateOrCreate(
        ['apple_id' => $idToken['sub']],
        [
            'email' => $idToken['email'] ?? null,
            'email_verified_at' => $idToken['email_verified'] ? now() : null,
            // Имя сохраняем только если пришло (первый вход)
            'name' => $appleUser ? trim(($appleUser['name']['firstName'] ?? '') . ' ' . ($appleUser['name']['lastName'] ?? '')) : null,
        ]
    );

    // Обновляем имя только если оно не было установлено ранее
    if ($appleUser && !$user->name) {
        $user->update(['name' => ...]);
    }

    Auth::login($user);
    return redirect()->intended('/dashboard');
}

אימות id_token

Apple מפרסמת מפתחות ציבוריים ב-1. Редирект пользователя: GET https://appleid.apple.com/auth/authorize ?client_id=com.example.web &redirect_uri=https://example.com/auth/apple/callback &response_type=code id_token &response_mode=form_post &scope=name email &state=<random_string> &nonce=<random_nonce> 2. Apple делает POST на redirect_uri с: - code - id_token - state - user (JSON с именем — только при первом входе!) . אימות באמצעות JWT:

// composer require firebase/php-jwt
use Firebase\JWT\JWT;
use Firebase\JWT\JWK;

$keys = Cache::remember('apple_public_keys', 3600, function () {
    return Http::get('https://appleid.apple.com/auth/keys')->json();
});

$payload = JWT::decode($idToken, JWK::parseKeySet($keys));

// Проверить: iss = appleid.apple.com, aud = client_id, exp, nonce

עבודה עם אימייל ממסלול מנותב

אם המשתמש מסתיר את האימייל שלו, Apple מנפיקה כתובת ממסלול מנותב response_mode=form_post. אימיילים לכתובת זו מגיעים רק אם הדומיין רשום ב-Apple Developer Console → More → Configure Sign in with Apple for Email Communication. אנו עוזרים להגדיר תהליך זה כך שהודעות יישלחו.

בפרויקט אחד, אימייל ממסלול מנותב נכשל כי הדומיין לא היה רשום—השגיאה עלתה ללקוח בחלק מההזמנות. זיהינו במהירות את הסיבה והגדרנו את המיפוי, והחזרנו את משלוח האימיילים.

מה כלול בעבודה

• רישום האפליקציה ב-Apple Developer (App ID, Services ID, Key)
• יצירת client_secret JWT עם חידוש אוטומטי דרך cron
• יישום OAuth callback עם אימות id_token ו-state
• טיפול באימייל ממסלול מנותב ושם מוסתר (שמירה בכניסה הראשונה)
• שילוב עם Laravel Socialite Apple או יישום מותאם אישית
• תיעוד לתחזוקה והעברת אישורים
• אחריות על הקוד וייעוץ חינם בתוך חודש לאחר המסירה

לוחות זמנים

סה"כ: 4–5 ימי עבודה.

כדי לקבל שילוב Apple ID מוכן, צרו קשר—נעריך את הפרויקט שלכם ונציע פתרון אופטימלי. לפי הנתונים שלנו, 40% ממשתמשי iOS נוטשים את ההתחברות אם Apple ID אינו זמין. הזמינו את השילוב היום וחסכו לעצמכם שעות של ניפוי שגיאות טיפוסיות.