Làm quen với tính năng Đăng nhập bằng Google 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 chỉ thực hiện điều đó. Sau đó, các bước tiếp theo sẽ mô tả cách tích hợp Đă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 Xcode hiện tại.

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 OAuth

Ứng dụng của bạn cần có mã ứng dụng khách OAuth để tự nhận dạng theo quy trình xác thực của Google phần phụ trợ. Đối với các ứng dụng iOS và macOS, loại ứng dụng có mã ứ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 OAuth, hãy nhấp vào nút này bên dưới để làm điều đó.

Tạo mã ứng dụng OAuth

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

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

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

Nhận mã ứng dụng khách của máy chủ OAuth

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

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

1. Mở dự án của bạn trong Bảng điều khiển Cloud.

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

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

Tính năng Đăng nhập bằng Google yêu cầu bạn định cấu hình dự án bằng mã ứng dụng OAuth và một 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ủ cho xác thực phần phụ trợ hoặc tối ưu hoá ứng dụng cho 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 OAuth mã ứng dụng khách và lược đồ URL tuỳ chỉnh dựa trên mã ứng dụng khách đảo ngược.

Mã ứng dụng khách bị đảo ngược là mã ứng dụng khách của bạn, có thứ tự là các dấu chấm được phân tách bằng dấu chấm đã đảo ngược các trường. Thông tin này cũng xuất hiện trong "Lược đồ URL dành cho iOS" khi chọn một ứng dụng OAuth hiện có của iOS trên Đám mây bảng điều khiển dành cho nhà phát triển. 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 phương thức xác thực phần phụ trợ

Nếu bạn cần thu hút người dùng Mã thông báo mã nhận dạng cho hoạt động xác thực phần phụ trợ, đặ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 vùng OpenID

Sử dụng thông 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 vùng OpenID.

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

Ký đơn đăng ký

Ứng dụng của bạn phải được ký bằng một chứng chỉ do Apple cấp để chạy có sẵn trên thiết bị macOS và iOS để lưu trữ thông tin đăng nhập qua chuỗi khoá.

Các bước tiếp theo

Bây giờ, bạn đã tải các phần phụ thuộc của dự án xuống và định cấu hình bản Xcode của mình 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.