Bắt đầu sử dụng tính năng Đăng nhập bằng Google dành cho iOS và macOS

Trước khi có thể bắt đầu tích hợp ứng dụng iOS hoặc macOS với các thành phần Đăng nhập bằng Google, bạn phải tải các phần phụ thuộc xuống và định cấu hình dự án Xcode của mình. Các bước trên trang này sẽ thực hiện việc đó. Các bước tiếp theo mô tả cách tích hợp các tính năng Đăng nhập bằng Google vào ứng dụng của bạn.

Trước khi bắt đầu

Cài đặt phiên bản hiện tại của Xcode.

Cài đặt phần phụ thuộc Đăng nhập bằng Google trong dự án của bạn

Lấy mã ứng dụng khách OAuth

Ứng dụng cần mã ứng dụng khách OAuth để tự xác định với phần phụ trợ xác thực của Google. Đối với các ứng dụng dành cho iOS và macOS, loại ứng dụng mã nhận dạng ứng dụng khách OAuth phải được định cấu hình là iOS.

Nếu bạn chưa tạo mã ứng dụng khách OAuth, hãy nhấp vào nút bên dưới để thực hiện việc này.

Tạo mã ứng dụng khách OAuth

Sau khi tạo mã ứng dụng khách OAuth, bạn hãy ghi lại chuỗi mã ứng dụng khách mà bạn cần định cấu hình cho tính năng Đăng nhập bằng Google trong ứng dụng. Bạn có thể tuỳ ý tải tệp cấu hình xuống (chứa mã ứng dụng và dữ liệu cấu hình khác) để tham khảo trong tương lai.

Nếu đã tạo mã ứng dụng khách OAuth, bạn có thể tìm thông tin OAuth hiện có bằng cách nhấp vào nút bên dưới.

Lấy mã ứng dụng khách OAuth hiện có

Lấy mã ứng dụng khách của máy chủ OAuth

Hầu hết các ứng dụng đều cần chuyển danh tính của người dùng đã đăng nhập vào một loại dịch vụ phụ trợ. Để chuyển một cách an toàn danh tính người dùng đã đăng nhập bằng Google vào chương trình phụ trợ của bạn, bạn sẽ sử dụng mã thông báo mã nhận dạng như đã thảo luận trong phần Xác thực bằng máy chủ phụ trợ. Việc truy xuất mã thông báo mã nhận dạng của người dùng yêu cầu mã ứng dụng khách thứ hai (mã ứng dụng máy chủ) đại diện cho phần phụ trợ.

Cách tạo mã ứng dụng máy chủ:

1. Mở dự án của bạn trong Cloud console.

2. Tạo một mã ứng dụng khách OAuth loại Ứng dụng web mới. Ghi lại chuỗi mã ứng dụng khách mà bạn sẽ cần để định cấu hình cho tính năng Đăng nhập bằng Google trong ứng dụng của mình.

Định cấu hình dự án ứng dụng

Để đăng nhập bằng Google, bạn cần định cấu hình dự án bằng mã ứng dụng khách OAuth và lược đồ URL tuỳ chỉnh. Nếu muốn, bạn cũng có thể thêm mã ứng dụng khách của máy chủ để xác thực phụ trợ hoặc tối ưu hoá ứng dụng cho miền Google Workspace.

Thêm mã ứng dụng khách OAuth và lược đồ URL tuỳ chỉnh

Cập nhật tệp Info.plist của ứng dụng để thêm mã ứng dụng khách OAuth và lược đồ URL tuỳ chỉnh dựa trên mã ứng dụng khách đảo ngược.

Mã khách hàng đảo ngược là mã ứng dụng khách của bạn, theo thứ tự ngược lại với các trường được phân tách bằng dấu chấm. Trạng thái này cũng xuất hiện trong phần "Lược đồ URL dành cho iOS" khi chọn một ứng dụng OAuth hiện có trên iOS trong Cloud Console. Ví dụ: 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>

Không bắt buộc: Định cấu hình xác thực phụ trợ

Nếu bạn cần lấy mã thông báo mã nhận dạng người dùng để xác thực phụ trợ, hãy đặt khoá GIDServerClientID trong tệp Info.plist của ứng dụng.

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

Không bắt buộc: Tối ưu hoá cho miền Google Workspace hoặc lĩnh vực Orkut

Dùng tham số GIDHostedDomain nếu bạn muốn tối ưu hoá quy trình đăng nhập cho một miền Google Workspace.

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

Sử dụng tham số GIDOpenIDRealm nếu bạn muốn chỉ định một vùng MPN.

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

Ký ứng dụng

Ứng dụng phải được ký bằng chứng chỉ do Apple cấp để chạy nguyên gốc trên các thiết bị macOS và iOS nhằm lưu trữ thông tin xác thực thông qua chuỗi khoá.

Các bước tiếp theo

Sau khi tải các phần phụ thuộc của dự án xuống và định cấu hình dự án Xcode, bạn có thể thêm Tính năng đăng nhập bằng Google vào ứng dụng iOS của mình.