EOS SDK for iOS Samples

iOS 샘플 및 Apple 로그인 플로 개요입니다.

7 분 소요

SDK로 로그인하기 위해 인증 인터페이스를 사용하는 방법을 보여주는 로그인 샘플(Login Sample) 을 현재 사용할 수 있습니다.

또는 이 샘플에서 Apple로 로그인 네이티브 지원 옵션을 활성화할 수도 있지만, 이 기능이 활성화되면 번들 식별자 및 프로비저닝 프로파일 을 사용해야 합니다. 필요한 추가 세팅 조정은 아래에서 설명됩니다. 이 기능은 기본적으로 비활성화됩니다.

이 페이지에서는 표준 로그인 플로와 SIWA 플로 모두에서 iOS의 로그인 샘플을 사용하는 방법을 알아봅니다. 이 샘플은 Xcode 11.3.1 및 iOS SDK 13.2 를 사용하여 개발됐습니다.

시작하기 전에

Login/Settings/settings.json 에서 애플리케이션과 관련된 값을 알맞게 설정했는지 확인하세요. 값을 알맞게 설정하지 않으면 SDK가 제대로 실행되지 않습니다. 필요한 세팅은 다음과 같습니다.

  • productId: 제품 ID
  • sandboxId: 샌드박스 ID
  • deploymentId: 배포 ID
  • clientId: 클라이언트 ID
  • clientSecret: 클라이언트 비밀 키

위 세팅에 사용할 값이 아직 없다면 개발자 포털에서 자세한 정보를 알아볼 수 있습니다.

일부 추가 Xcode 세팅도 다음과 같이 구성해야 합니다.

  1. Login/Info.plist 를 선택하고 URL 유형(URL types) > 항목 0(Item 0) > URL 스킴(URL Schemes) > 항목 0(Item 0) 으로 이동합니다. 이 값은 eos.clientId (clientId는 JSON 파일의 데이터와 같음)로 설정되어야 합니다. 이렇게 되면 계정 포털이 웹의 결과 로그인 데이터로 애플리케이션을 리트리거할 수 있습니다.

  2. EOSSDK.framework 를 Login/Frameworks 폴더로 복사합니다.

  3. 샘플을 빌드하고 샘플에 서명할 수 있도록 서명 및 기능(Signing & Capabilities) 세팅에서 번들 식별자도 설정해야 합니다.

Apple로 로그인

Apple로 로그인(Sign in with Apple, SIWA) 기능은 iOS 13 이상 에서만 지원됩니다.

이 샘플에서 SIWA 지원을 활성화하려면 Xcode에서 일부 세팅을 추가로 설정해야 합니다.

  1. 번들 식별자를 사용하려면 Apple 개발자 포털의 인증서, 식별자 및 프로파일(Certificates, Identifiers & Profiles) 에 있는 식별자(Identifiers) 에서 Apple로 로그인(Sign in with Apple) 기능을 활성화해야 합니다.

  2. 프로젝트의 서명 및 기능(Signing & Capabilities) 세팅에서 + 기능(+ Capability) 옵션을 사용하여 Apple로 로그인(Sign in with Apple) 지원을 애플리케이션에 추가합니다.

  3. 빌드 세팅(Build Settings) 에서 Swift 컴파일러 - 커스텀 플래그(Swift Compiler - Custom Flags) > 활성 컴파일 조건(Active Compilation Conditions) 을 찾고 EOS_ENABLE_SIWA 정의를 디버그(Debug) 필드와 릴리즈(Release) 필드에 모두 추가합니다.

로그인

처음 앱을 시작하면 로그인 버튼이 있는 화면이 나타납니다. SIWA를 활성화했다면 두 가지 로그인 옵션이 표시됩니다.

EOS_NotFound 메시지가 표시된 로그인 화면

이미지를 클릭하면 최대 크기로 볼 수 있습니다.

앱을 열 때마다 퍼시스턴트 인증을 사용하여 최근 로그인 크리덴셜로 자동 로그인을 시도합니다. 로그인한 적이 없다면 퍼시스턴트 인증이 기존 크리덴셜을 찾을 수 없습니다.

계정 포털로 로그인하기

로그인(Login) 버튼을 누르면 보안 세션이 시작되며 OS가 브라우저에서 로그인 프로세스를 계속할지 묻는 메시지를 표시합니다. 이 메시지는 브라우저에서 열릴 타깃 도메인과 애플리케이션 이름을 알려줍니다.

계정 포털로 로그인하기

이미지를 클릭하면 최대 크기로 볼 수 있습니다.

계속(Continue) 을 누르면 에픽 계정 포털에서 브라우저가 열리면서 에픽 계정에 로그인하도록 요청하는 메시지가 표시됩니다.

이미지를 클릭하면 최대 크기로 볼 수 있습니다.

이미지를 클릭하면 최대 크기로 볼 수 있습니다.

이미지를 클릭하면 최대 크기로 볼 수 있습니다.

이미지를 클릭하면 최대 크기로 볼 수 있습니다.

이 플로를 완료하면 앱으로 돌아가며 로그인 상태가 확인됩니다.

이미지를 클릭하면 최대 크기로 볼 수 있습니다.

여기서 로그아웃하거나, 애플리케이션을 종료한 뒤 다시 열어 퍼시스턴트 로그인 플로를 살펴볼 수 있습니다.

SIWA로 로그인하기(Apple로 로그인)

SIWA를 활성화한 샘플을 빌드한 경우 앱을 시작하면 두 개의 로그인 버튼이 있는 화면이 표시됩니다. 상단 로그인 버튼을 누르면 이전 섹션의 계정 포털 로그인 플로로 이동합니다. Apple로 로그인(Sign in with Apple) 버튼을 누르면 SIWA 플로로 이동합니다.

이미지를 클릭하면 최대 크기로 볼 수 있습니다.

SIWA를 처음 사용하는 경우 이름, 이메일 주소 등 어떤 데이터를 애플리케이션과 공유할지 묻는 메시지가 표시됩니다(자세한 내용은 공식 Apple 문서 참조). 이후에 로그인할 때는 ID를 확인하는 메시지가 표시됩니다.

이미지를 클릭하면 최대 크기로 볼 수 있습니다.

이 플로를 완료하면 앱으로 돌아가며 연결 로그인 상태가 확인됩니다.

이미지를 클릭하면 최대 크기로 볼 수 있습니다.

여기서 뒤로(Back) 를 선택하여 다른 로그인 옵션으로 돌아갈 수 있습니다.