Android에서 Apple Login

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

Android에서 Apple 로그인 구현은 다소 비공식적인 방식입니다. Apple이 공식적으로 Sign in with Apple Android를 지원하지 않기 때문에, 솔루션이 약간 비공식적인(hacky) 방식입니다.

Android는 현재 Chrome Tabs를 사용하여 OAuth2 웹사이트를 표시합니다. 이 방식에는 다음과 같은 어려움이 있습니다:

복잡한 설정
백엔드가 필요합니다

Android에서의 동작 흐름 이해하기

안드로이드에서의 흐름을 다이어그램으로 설명하겠습니다:

flowchart TD
    A("await SocialLogin.login()") -->|Handled in the plugin|B(Generate the login URL)
    B --> |Pass the link| C(Open the Chrome browser)
    C --> D(Wait for the user to login)
    D --> |Apple redirects to your backend|E(Handle the data returned from Apple)
    E --> F(Redirect back to the app)
    F --> G(Return to JS)

이제 문제점과 흐름을 이해했으니, 설정을 시작해 보겠습니다.

Service ID 생성하기

에 로그인하세요 Apple Developer Portal.
클릭하세요 Identifiers.

다음과 같은 화면이 나타납니다:
1. 이 필드가 다음과 같이 표시되는지 확인하세요: App IDs
2. App ID를 찾을 수 있는지 확인하세요.
  iOS용 Apple Login 설정이 되어 있지 않다면 새로 생성해야 합니다. 저는 이미 하나 만들어 두었습니다. 사용할 App ID는 me.wcaleniewolny.test.ionic.vue입니다. 아직 없다면 다음을 따라 생성하세요: 앱 생성 단계.
앱에 대해 Sign in with Apple 기능이 활성화되어 있는지 확인하세요
1. 앱을 클릭하세요
2. 다음 항목 확인 Sign in with Apple capability가 활성화되어 있습니다
3. 활성화되어 있지 않으면 활성화하세요.
전체 목록으로 돌아가기 All Identifiers
클릭하세요 App Ids 그리고 다음으로 이동합니다: Services IDs
새 식별자 생성
1. 더하기 버튼 클릭
2. 선택 Servcice IDs 그리고 클릭하세요: Continue
3. 설명과 식별자를 입력한 후 클릭 Continuie.
  
  이 identifiers 는 clientId 가 되며, 이 값은 initialize 함수에 전달할 값이고, ANDROID_SERVICE_ID 는 백엔드용입니다.
  꼭 저장해 두세요!!!
  
  Service ID는 App ID와 일치할 필요는 없지만, Service ID를 YOUR_APP_ID.service 로 설정하는 것을 권장합니다. 참고로 저는 me.wcaleniewolny.test.ionic.vue 를 앱 ID로 사용하고 있지만, ee.forgr.io.ionic.service2 를 Service ID로 사용하고 있습니다.
4. 세부 정보를 확인한 후 클릭하세요 Register
5. 새로 생성된 서비스를 클릭하세요
6. 활성화: Sign in with Apple 옵션
7. 다음 항목 구성 Sign In with Apple
8. 다음 항목 확인 Primary App ID 이전 단계에서 구성한 App ID로 설정되어 있는지
9. 백엔드를 호스팅할 도메인을 추가하세요.
  
  이 백엔드는 반드시 HTTPS에서 실행 중이어야 합니다. ...에 관해서는 Return URLs이 튜토리얼의 다음 섹션을 읽고 백엔드 설정을 마친 뒤에 이 부분을 다시 확인하는 것이 좋습니다. 이 튜토리얼에서는 https://xyz.wcaleniewolny.me/login/callback 를 return URL로, xyz.wcaleniewolny.me 를 도메인으로 사용하겠습니다. 다음을 누르세요.
10. 데이터를 확인하고 클릭하세요 Done
11. 클릭하세요 Continue
12. 클릭하세요 Save

키 생성 중

모두로 돌아가기 All Identifiers
클릭하세요 Keys
더하기 아이콘 클릭
키 이름 지정

이 이름은 중요하지 않으니 아무거나 입력해도 됩니다.
선택 Sign in with Apple 그리고 클릭하세요: Configure
기본 App ID를 선택한 후 누르세요 Save

이전 단계에서 사용한 App ID와 반드시 동일해야 합니다.
클릭하세요 Continue
클릭하세요 Register
Key ID를 복사하고 키를 다운로드하세요.

중요: 이 ID를 저장하세요. 백엔드에서는 다음과 같이 불립니다: KEY_ID. 키를 다운로드하세요. 이 키는 절대 공유하지 마세요.
다운로드한 키를 찾아 백엔드 폴더에 저장하세요.

Team ID 가져오기

사용하려면 Login with Apple Android에서는 다음을 가져와야 합니다: Team ID. 이는 백엔드에서 사용됩니다.

다음으로 이동: 이 웹사이트 아래로 스크롤하여
다음 Team ID

앱 리다이렉트 설정

다이어그램에서 보았듯이, 백엔드에서 다음 단계가 수행됩니다. Redirect back to the app이 작업에는 앱에 대한 수동 변경이 필요합니다.

다음을 수정하세요: AndroidManifest.xml

파일을 열고, 사용하겠습니다 AndroidStudio

다음 MainActivity 열고 다음 Intent filter를 추가하세요

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="capgo-demo-app" android:host="path" />
</intent-filter>

다음을 수정하세요: MainActivity

다음 파일을 여세요 MainActivity

다음 code을 추가하세요:

@Override
protected void onNewIntent(Intent intent) {
    String action = intent.getAction();
    Uri data = intent.getData();

    if (Intent.ACTION_VIEW.equals(action) && data != null) {
        PluginHandle pluginHandle = getBridge().getPlugin("SocialLogin");
        if (pluginHandle == null) {
            Log.i("Apple Login Intent", "SocialLogin login handle is null");
            return;
        }
        Plugin plugin = pluginHandle.getInstance();
        if (!(plugin instanceof SocialLoginPlugin)) {
            Log.i("Apple Login Intent", "SocialLogin plugin instance is not SocialLoginPlugin");
            return;
        }
        ((SocialLoginPlugin) plugin).handleAppleLoginIntent(intent);
        return;
    }
    super.onNewIntent(intent);
}

백엔드 설정

Android에는 백엔드가 필수이지만, 백엔드 설정은 iOS에도 영향을 미칩니다. 예시 백엔드가 제공됩니다. 여기

이 예제는 다음을 제공합니다:

간단한 JSON 데이터베이스
Apple 서버에서 JWT를 요청하는 방법
간단한 JWT 검증

이 튜토리얼의 내용을 바탕으로 구성한 env 섹션의 모습은 다음과 같습니다:

ANDROID_SERVICE_ID = 서비스 ID
IOS_SERVICE_ID = 앱 ID

env: {
  PRIVATE_KEY_FILE: "AuthKey_U93M8LBQK3.p8",
  KEY_ID: "U93M8LBQK3",
  TEAM_ID: "UVTJ336J2D",
  ANDROID_SERVICE_ID: "ee.forgr.io.ionic.starter.service2",
  IOS_SERVICE_ID: "me.wcaleniewolny.test.ionic.vue",
  PORT: 3000,
  REDIRECT_URI: "https://xyz.wcaleniewolny.me/login/callback",
  BASE_REDIRECT_URL: "capgo-demo-app://path"
}

플러그인 사용하기

사용법은 login 함수는 바뀌지 않으며 iOS와 동일합니다. 자세한 내용은 해당 섹션을 참고하세요. 하지만, initialize 메서드는 약간 다릅니다.

await SocialLogin.initialize({
  apple: {
    clientId: 'ee.forgr.io.ionic.starter.service2',
    redirectUrl: 'https://appleloginvps.wcaleniewolny.me/login/callback'
  }
})

앱 생성 시

App ID가 없다면 플러스(+) 버튼을 클릭하세요
선택 App IDs 그리고 Continue를 클릭하세요
유형을 클릭하세요 App 그리고 클릭하세요: Continue
설명과 App ID를 입력하세요
활성화 Sign with Apple Capability
클릭 Continue
상세 정보를 확인하고 클릭하세요 Register

사용 중이라면 Android에서 Apple Login 인증 및 계정 흐름을 설계할 때, 이를 다음 항목과 연결하세요: @capgo/capacitor-social-login 사용하기 @capgo/capacitor-social-login 사용 시 네이티브 기능을 위해, @capgo/capacitor-social-login @capgo/capacitor-social-login의 구현 세부 사항은, @capgo/capacitor-passkey @capgo/capacitor-passkey의 구현 세부 사항은 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric의 구현 세부 사항은, 2단계 인증 2단계 인증의 구현 세부 사항에 대해서는