iOS 및 macOS용 Google 로그인 시작하기

iOS 또는 macOS 앱을 Google 로그인 구성요소와 통합하려면 먼저 종속 항목을 다운로드하고 Xcode 프로젝트를 구성해야 합니다. 이를 위해서는 이 페이지의 단계를 따라야 합니다. 다음 단계에서는 Google 로그인 기능을 앱에 통합하는 방법을 설명합니다.

시작하기 전에

Xcode의 최신 버전을 설치합니다.

프로젝트에 Google 로그인 종속 항목 설치

CocoaPods

  1. 아직 CocoaPods를 설치하지 않았다면 CocoaPods 시작하기 가이드의 단계를 따릅니다.

  2. 터미널 창을 열고 앱의 Xcode 프로젝트 위치로 이동합니다.

  3. 애플리케이션의 Podfile을 아직 만들지 않았다면 지금 만듭니다. 

    pod init

  4. 애플리케이션용으로 만든 Podfile을 열고 다음을 추가합니다. 

    pod 'GoogleSignIn'

  5. SwiftUI를 사용하는 경우 'Google 계정으로 로그인' 버튼의 포드 확장 프로그램도 추가합니다. 

    pod 'GoogleSignInSwiftSupport'

  6. 파일을 저장하고 다음을 실행합니다. 

    pod install

  7. Xcode에서 애플리케이션용으로 생성된 .xcworkspace 작업공간 파일을 엽니다. 향후 애플리케이션에서 모든 개발에 이 파일을 사용합니다. 이는 열 때 빌드 오류를 일으키는 포함된 .xcodeproj 프로젝트 파일과는 다릅니다.

    Objective-C 샘플 앱의 Podfile에서 예를 참조하세요.

Swift Package Manager

  1. Xcode에서 프로젝트를 엽니다.

  2. 앱에 Google 로그인 종속 항목을 추가합니다(Xcode 문서).

    저장소 https://github.com/google/GoogleSignIn-iOS
    버전 7.0.0
    패키지 제품 GoogleSignIn

  3. SwiftUI를 사용하는 경우 'Google 계정으로 로그인' 버튼에 다음 확장 프로그램 패키지 제품도 추가합니다.

    패키지 제품 GoogleSignInSwift

OAuth 클라이언트 ID 가져오기

Google의 인증 백엔드에서 앱을 식별하려면 OAuth 클라이언트 ID가 필요합니다. iOS 및 macOS 앱의 경우 OAuth 클라이언트 ID 애플리케이션 유형을 iOS로 구성해야 합니다.

OAuth 클라이언트 ID를 아직 만들지 않았으면 아래 버튼을 클릭하여 만듭니다.

OAuth 클라이언트 ID 만들기

OAuth 클라이언트 ID를 만든 후 앱에서 Google 로그인을 구성해야 하는 클라이언트 ID 문자열을 기록해 둡니다. 나중에 참조할 수 있도록 클라이언트 ID와 기타 구성 데이터가 포함된 구성 파일을 선택적으로 다운로드할 수 있습니다.

OAuth 클라이언트 ID를 이미 만든 경우 아래 버튼을 클릭하여 기존 OAuth 정보를 확인할 수 있습니다.

기존 OAuth 클라이언트 ID 가져오기

OAuth 서버 클라이언트 ID 가져오기

대부분의 앱은 일종의 백엔드 서비스에 로그인한 사용자의 ID를 전달해야 합니다. Google로 로그인한 사용자의 ID를 백엔드에 안전하게 전달하려면 백엔드 서버에서 인증에 설명된 대로 ID 토큰을 사용합니다. 사용자의 ID 토큰을 검색하려면 백엔드를 나타내는 두 번째 클라이언트 ID(서버 클라이언트 ID)가 필요합니다.

서버 클라이언트 ID를 만들려면 다음 안내를 따르세요.

  1. Cloud Console에서 프로젝트를 엽니다.

  2. 새로운 웹 애플리케이션 유형의 OAuth 클라이언트 ID를 만듭니다. 앱에서 Google 로그인을 구성하는 데 필요한 클라이언트 ID 문자열을 기록해 둡니다.

애플리케이션 프로젝트 구성

Google 로그인을 사용하려면 OAuth 클라이언트 ID 및 커스텀 URL 스키마로 프로젝트를 구성해야 합니다. 원하는 경우 백엔드 인증을 위한 서버 클라이언트 ID를 추가하거나 Google Workspace 도메인에 맞게 앱을 최적화할 수도 있습니다.

OAuth 클라이언트 ID 및 맞춤 URL 스키마 추가하기

앱의 Info.plist 파일을 업데이트하여 OAuth 클라이언트 ID 및 역방향 클라이언트 ID를 기반으로 한 커스텀 URL 스키마를 추가합니다.

반전된 클라이언트 ID는 점으로 구분된 필드 순서가 바뀐 클라이언트 ID입니다. Cloud Console에서 기존 iOS OAuth 클라이언트를 선택할 때 'iOS URL 스키마'에도 표시됩니다. 예: com.googleusercontent.apps.1234567890-abcdefg

<key>GIDClientID</key>
<string>YOUR_IOS_CLIENT_ID</string>
<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
    </array>
  </dict>
</array>

선택사항: 백엔드 인증 구성

백엔드 인증을 위해 사용자의 ID 토큰을 가져와야 하는 경우 앱의 Info.plist 파일에도 GIDServerClientID 키를 설정합니다.

<key>GIDServerClientID</key>
<string>YOUR_SERVER_CLIENT_ID</string>

선택사항: Google Workspace 도메인 또는 OpenID 영역에 최적화하기

Google Workspace 도메인의 로그인 과정을 최적화하려면 GIDHostedDomain 매개변수를 사용합니다.

<key>GIDHostedDomain</key>
<string>YOUR_HOSTED_DOMAIN</string>

OpenID 영역을 지정하려면 GIDOpenIDRealm 매개변수를 사용합니다.

<key>GIDOpenIDRealm</key>
<string>YOUR_OPENID_REALM</string>

애플리케이션 서명

키체인을 통해 사용자 인증 정보를 저장하려면 macOS 및 iOS 기기에서 기본적으로 실행되도록 Apple에서 발급한 인증서로 애플리케이션을 서명해야 합니다.

다음 단계

프로젝트 종속 항목을 다운로드하고 Xcode 프로젝트를 구성했으므로 iOS 앱에 Google 로그인을 추가할 수 있습니다.