Using the iOS SDK Samples

iOS 샘플 및 Apple 로그인 플로 개요

4 분 소요

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

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

이 페이지에서는 표준 로그인 플로와 SIWA 플로 모두에서 iOS의 로그인 샘플을 사용하는 방법을 알아봅니다. 이 샘플은 Xcode 11.3.1iOS 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.frameworkLogin/Frameworks 폴더로 복사합니다.

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

Apple로 로그인

Apple로 로그인 기능은 iOS 13 이상 에서만 지원됩니다.

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

  1. 번들 식별자를 사용하려면 Apple Developer 포털의 인증서, 식별자 및 프로파일(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) 를 선택하여 다른 로그인 옵션으로 돌아갈 수 있습니다.