Đăng ký ứng dụng OAuth 2.0

Đăng ký ứng dụng OAuth 2.0 của bạn cho phép nó truy cập vào các tài nguyên Roblox. Sau khi đăng ký, Roblox sẽ cấp cho ứng dụng một ID khách hàng và bí mật duy nhất mà bạn có thể sử dụng để nhận quyền truy cập từ người dùng cho thông tin và tài nguyên Roblox của họ.

Đăng ký ứng dụng của bạn

Để đăng ký một ứng dụng:

1. Trong Bảng điều khiển Người sáng tạo, hãy truy cập vào trang Ứng dụng OAuth 2.0.
2. Nhấp vào nút Tạo ứng dụng.
3. Nhập một Tên ứng dụng hợp lệ và duy nhất toàn cầu.
4. Đọc và đồng ý với Điều khoản Dịch vụ của Roblox và nhấp vào Tạo.
5. Sao chép và lưu trữ ID khách hàng và Bí mật ở nơi an toàn. Sau khi đóng trang, bạn sẽ không còn quyền truy cập vào bí mật và chỉ có thể tạo một cái mới. Sau khi bạn hoàn thành việc đăng ký ứng dụng, bạn vẫn có thể truy cập và chỉnh sửa các thuộc tính khác của ứng dụng.
6. Nhấp vào Tiếp tục chỉnh sửa để cấu hình ứng dụng của bạn, điều này được mô tả trong các phần tiếp theo.

Cấu hình thông tin chung

Một khi bạn đã đăng ký ứng dụng của mình, bạn nên cấu hình thông tin chung của nó, bao gồm:

• Một mô tả, sẽ hiển thị cho mọi người trong cộng đồng Roblox.
• Một hình ảnh thu nhỏ cho ứng dụng của bạn. Kích thước tệp khuyến nghị ít nhất là 150x150 pixel.
• Một Liên kết đầu vào làm điểm vào của ứng dụng của bạn, chẳng hạn như trang web chính của ứng dụng.
• Một URL Điều khoản Bảo mật và một URL Điều khoản Dịch vụ để người dùng cuối đọc trước khi ủy quyền cho ứng dụng của bạn. Mỗi URL phải là HTTPS và không quá 256 ký tự.

Thêm quyền

Để đảm bảo kiểm soát truy cập và bảo mật đúng cách trong ứng dụng của bạn, bạn phải thêm Phạm vi quyền. Có hai loại phạm vi quyền có sẵn:

• Phạm vi danh tính cho xác thực, chẳng hạn như openid cho ID người dùng và profile cho hồ sơ đầy đủ. Nếu bạn chọn phạm vi profile, bạn cũng phải chọn openid.
• Phạm vi quyền cụ thể của API, chẳng hạn như asset:read cho quyền đọc tài sản. Chỉ chọn số lượng phạm vi tối thiểu mà bạn cần cho ứng dụng của bạn.

Thêm URL chuyển hướng

URL chuyển hướng là các điểm vào lại của ứng dụng của bạn mà người dùng được chuyển hướng đến khi họ hoàn thành việc ủy quyền cho ứng dụng của bạn. Đảm bảo rằng các URL chuyển hướng của bạn đáp ứng các yêu cầu sau:

• Tất cả các URL chuyển hướng phải ở một trong những dạng sau:

  • HTTPS thuần túy, ví dụ: https://www.example.com.
  • Đường dẫn trên localhost với HTTP hoặc HTTPS (chứng chỉ tự ký) cho mục đích gỡ lỗi cục bộ, ví dụ:

    • http://localhost:80
    • https://localhost:80
  • Các sơ đồ tùy chỉnh cho các ứng dụng hoặc mục đích cụ thể, ví dụ:

    • my-app-scheme:/
    • my-app-scheme://foo/bar/...
    • my-app://action?param1=value1&param2=value2
• Độ dài tối đa của một URL chuyển hướng là 256 ký tự.
• Bạn có thể thêm tới 10 URL chuyển hướng. Với nhiều URL chuyển hướng, bạn có thể có các môi trường thử nghiệm và cho phép người dùng chuyển đổi giữa hai trang mà không bị ngừng hoạt động.

Gửi để đánh giá

Để giảm thiểu khả năng ứng dụng độc hại gây hại cho cộng đồng, việc đăng ký một ứng dụng không khiến nó trở nên có sẵn rộng rãi. Thay vào đó, nó vẫn ở chế độ riêng tư với giới hạn 10 người dùng duy nhất. Chế độ này rất hữu ích cho việc thử nghiệm và gỡ lỗi trong nhóm của bạn.

Nếu bạn muốn mở rộng nhóm người dùng cho ứng dụng của mình, bạn cần phát hành nó ở chế độ công khai bằng cách gửi nó để đánh giá:

1. Truy cập trang ứng dụng OAuth 2.0.
2. Nhấp vào nút Chỉnh sửa và Xuất bản cho ứng dụng mà bạn muốn xuất bản.
3. Điền vào tất cả thông tin cần thiết và nhấp vào nút Đánh giá và Xuất bản. Một thông điệp với các giới hạn về quyền truy cập của ứng dụng bạn trong thời gian đánh giá đang chờ xử lý sẽ xuất hiện.
4. Nhấp vào Gửi để Đánh giá.

Khi đánh giá ứng dụng của bạn đang chờ xử lý, bạn không thể chỉnh sửa hoặc gửi yêu cầu khác cho đến khi yêu cầu đánh giá hiện tại được chấp thuận hoặc từ chối. Ứng dụng của bạn vẫn ở chế độ riêng tư trong quá trình đánh giá. Khi ứng dụng của bạn được chấp thuận, nó sẽ chuyển sang chế độ công khai, và bạn không thể quay lại chế độ riêng tư.

Bất kể ứng dụng của bạn được chấp thuận hay từ chối, bạn sẽ nhận được thông báo qua email về kết quả khi quá trình đánh giá hoàn tất.

Chỉnh sửa và xóa ứng dụng của bạn

Bạn có thể chỉnh sửa hoặc xóa ứng dụng của mình với các bước sau nếu nó không đang trong quá trình đánh giá:

1. Truy cập trang ứng dụng OAuth 2.0.

2. Nhấp vào Chỉnh sửa hoặc Xóa cho ứng dụng mong muốn.

   • Nếu bạn chọn chỉnh sửa một ứng dụng, hãy làm theo cùng các bước và yêu cầu của đăng ký.
   • Nếu bạn chọn xóa một ứng dụng, hãy nhấp vào Có, Xóa để xác nhận việc xóa. Sau khi bạn xóa một ứng dụng, bạn không thể khôi phục lại nó.

Việc thay đổi thông tin chung của ứng dụng hoặc các URL chuyển hướng không yêu cầu người dùng phải ủy quyền lại ứng dụng. Tuy nhiên, nếu bạn thêm hoặc thay đổi phạm vi quyền, bạn phải nhận được sự ủy quyền cho các quyền mới từ người dùng của mình và thu được một tập hợp các mã thông báo mới. Nếu bạn không nhận được sự ủy quyền cho các phạm vi mới, ứng dụng của bạn có thể tiếp tục sử dụng các mã thông báo hiện có, nhưng bị giới hạn ở các phạm vi trước đó.

Đối với các ứng dụng ở chế độ riêng tư, hệ thống tự động cập nhật các chỉnh sửa của bạn với người dùng. Đối với các ứng dụng ở chế độ công khai, bạn phải lại gửi ứng dụng để đánh giá để phản ánh các thay đổi này. Nếu không, hệ thống sẽ lưu các thay đổi chưa công bố cho bạn mà không phát hành nó ra cộng đồng.