Budun OS’ta Apple ile Giriş Nasıl Yapılandırılır?

Apple ile Giriş entegrasyonu, kullanıcıların Apple hesaplarıyla Budun OS’a giriş yapmasını sağlar. Bu rehberde Apple Developer hesabınızda gerekli tanımları oluşturmayı ve entegrasyon bilgilerini platformun yönetim paneline eklemeyi adım adım ele alıyoruz.

Başlamadan önce Apple Developer hesabınıza ve Budun OS yönetim paneline erişiminiz olduğundan emin olun. Örneklerdeki example.com adresini kendi alan adınızla değiştirin.

Bu rehber, Budun OS kurulumunun kaynak dokümandaki Sngine tabanlı sosyal giriş yapısını kullandığı varsayımıyla hazırlanmıştır. Özelleştirilmiş kurulumlarda menü adları ve dönüş adresi farklı olabilir.

1. App ID oluşturun

Apple Developer portalındaki Identifiers sayfasını açın ve hesabınızla giriş yapın.

1. Identifiers başlığının yanındaki + düğmesine tıklayın.
2. App IDs seçeneğini işaretleyip Continue ile ilerleyin.
3. Uygulama türü olarak App seçin.
4. Description alanına Budun OS yazın.
5. Bundle ID alanına, alan adınızın ters sıralamasını temel alan benzersiz bir kimlik girin. Örneğin: com.example.budunos.
6. Capabilities bölümünde Sign In with Apple özelliğini etkinleştirin.
7. Continue → Register adımlarıyla kaydı tamamlayın.

Oluşturduğunuz App ID’yi yeniden açın. Sign In with Apple → Edit bölümüne girerek Enable as a primary App ID seçeneğini işaretleyin ve Save ile kaydedin.

2. Services ID oluşturun

Services ID, web üzerinden Apple ile giriş için kullanılacak hizmet kimliğidir.

1. Identifiers sayfasına dönün ve filtreyi Services IDs olarak değiştirin.
2. Register a Services ID seçeneğine tıklayın.
3. Services IDs → Continue adımlarıyla ilerleyin.
4. Description alanına Budun OS Web Login gibi açıklayıcı bir ad yazın.
5. Identifier alanına benzersiz bir kimlik girin. Örneğin: com.example.budunos.siwa.
6. Continue → Register ile kaydı tamamlayın.

Yeni Services ID kaydını açın. Sign In with Apple özelliğini etkinleştirin ve Configure düğmesine tıklayın.

Web Authentication Configuration ekranında:

• Primary App ID: İlk adımda oluşturduğunuz App ID’yi seçin.
• Domains and Subdomains: Budun OS’un çalıştığı alan adını veya alt alan adını ekleyin.
• Return URLs: Apple oturum açma işleminin ardından kullanıcının yönlendirileceği dönüş adresini girin.

Kaynak dokümandaki yönlendirme yapısını kullanıyorsanız, dönüş adresiniz kurulumunuza göre aşağıdaki biçimlerden biri olacaktır:

Ana alan adı:
https://example.com/connect/apple

www ile kullanılan alan adı:
https://www.example.com/connect/apple

Alt alan adı:
https://community.example.com/connect/apple

Alt dizin:
https://example.com/budun/connect/apple

Adresin, platformunuzun kullandığı gerçek adresle eşleşmesine dikkat edin. www, alt alan adı veya alt dizin kullanıyorsanız bunları dönüş adresine de dahil edin.

Next → Done → Continue → Save adımlarıyla yapılandırmayı kaydedin.

3. Özel anahtar oluşturun

Apple ile Giriş entegrasyonu için bir özel anahtar oluşturmanız gerekir.

1. Apple Developer portalının sol menüsünden Keys bölümüne gidin.
2. + düğmesine tıklayın.
3. Key Name alanına Budun OS Apple Login gibi bir ad yazın.
4. Sign In with Apple seçeneğini etkinleştirin.
5. Edit düğmesine tıklayarak ilk adımda oluşturduğunuz App ID ile ilişkilendirin.
6. Continue → Register ile kaydı tamamlayın.
7. .p8 uzantılı anahtar dosyasını indirin ve Key ID değerini not edin.

Anahtar dosyası yalnızca bir kez indirilebilir. Dosyayı güvenli bir yerde saklayın; içeriğini herkese açık dokümanlarda veya kod depolarında paylaşmayın.

4. Budun OS yönetim panelini yapılandırın

Kaynak dokümandaki panel yapısını kullanıyorsanız şu yolu izleyin:

Yönetim Paneli → Ayarlar → Kayıt Ayarları → Sosyal Giriş
(Admin Panel → Settings → Registration Settings → Social Login)

Apple ile giriş bölümündeki alanları doldurun:

• Services ID: İkinci adımda oluşturduğunuz Services ID’nin Identifier değeri.
• Team ID: Apple Developer hesabınıza ait 10 karakterli takım kimliği.
• Key ID: Üçüncü adımda oluşturduğunuz anahtarın kimliği.
• Private Key: İndirdiğiniz .p8 dosyasının içeriği.

Services ID alanında App ID’nin Bundle ID değerini kullanmayın; bu iki kimlik farklı amaçlara hizmet eder.

Bilgileri kaydedin ve giriş sayfasından Apple ile giriş akışını deneyin. İşlem başarısız olursa öncelikle dönüş adresinin kurulum adresinizle eşleştiğini, Services ID’nin doğru App ID ile ilişkilendirildiğini ve anahtar bilgilerinin eksiksiz girildiğini kontrol edin.