Đăng ký OAuth 2.0

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

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

Đăng ký app của bạn

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

  1. Trong Creator Dashboard, hãy đến trang OAuth 2.0 Apps.
  2. Nhấp vào nút Tạo OAuth 2.0 App .
  3. Nhập một tên ứng dụng hợp lệ và độc đáo Tên ứng dụng .
  4. Đọc và đồng ý với Roblox Cộng với dịch vụ của Roblox và nhấn vào Tạo .
  5. Bản sao và lưu Client IDSecret ở một địa điểman toàn. Sau khi đóng trang, bạn không còn có quyền truy cập vào secret và chỉ có thể tạo một mới. Sau khi bạn kết thúc đăng ký một ứ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
  6. Nhấp vào Tiếp tục chỉnh sửa để tùy chỉnh ứng dụng của bạn, mà được mô tả trong các mục dưới đây.

Tùy chỉnh thông tin chung

Một khi bạn đã đăng nhập ứng dụngcủa bạn, bạn nên tùy chỉnh thông tin chung của nó, bao gồm:

  • Một mô miêu tả, which is visible to everyone in the Roblox community.
  • Hình ảnh bản xem trước cho ứng dụng của bạn. Kích thước tập tin được đề xuất là ít nhất 150x150 pixel.
  • Một Liên kết đăng nhập như là trang chủ của website ứng dụngcủa bạn, ví dụ như trang chủ của ứng dụngcủa bạn.
  • Một URL Cam kết quả riêng tư và một URL Dịch vụ Thương mại URL cho người dùng cuối cùng để đọc trước khi phê duyệt ứng dụng của bạn. Mỗi URL phải là HTTPS và không hơn 256 ký tự.

Thêm các quyền

Để đảm bảo kiểm soát quyền hạn và an toàn trong ứng dụng của bạn, bạn phải thêm Các khu vực quyền hạn . Có hai loại các khu vực quyền hạn có sẵn:

  • Các kết quả danh hiệu cho mục đích xác thực, như openid cho ID người dùng và profile cho các hồ sơ đầy đủ. Nếu bạn chọn kết quả 0> profile0>, bạn cũng phải chọn 3> openid 3>.
  • API-specific permission scopes , ví dụ như asset:read cho quyền truy cập của tài nguyên. Chọn chỉ số lượng tối thiểu của các scopes mà bạn cần cho ứng dụng của bạn.

Thêm URL điều hướng

Chuyển hướng URL là những điểm trở lại của app của bạn mà người dùng được chuyển hướng khi họ kết thúc việc xác nhận ứng dụngcủa bạn. Đảm bảo các điểm trở lại URL của bạn phù hợp với các yêu cầu sau đây:

  • Tất cả các URL đổi hướng đều phải nằm trong một trong những hình dạng sau đây:
    • Plain HTTPS, ví dụ: https://www.example.com .
    • Các con đường trên localhost với HTTP hoặc HTTPS (giấy chứng thư tự ký) cho mục đích debug local, ví dụ như:
      • http://localhost:80
      • https://localhost:80
    • Các công thức 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 đổi hướng là 256 ký tự.
  • Bạn có thể thêm lên đến 10 URL chuyển hướng. Với nhiều URL chuyển hướng, bạn có thể có môi trường thử nghiệm và cho phép người dùng di chuyển giữa hai trang web mà không cần phải chờ đợi.

Gửi điều kiện cho xem xét

Để giảm thiểu các khả năng xấu độc của các ứng dụng ảnh hưởng đến cộng đồng, đăng ký một ứng dụng không làm cho nó công khai khi đăng nhập vào nó. Thay vào đó, nó vẫn ở trong chế độ riêng tư với giới hạn 100 người dùng được phép.

Nếu bạn muốn mở rộng cơ sở người dùng cho ứng dụng của bạn, bạn cần phải xuất bản nó trong chế độ công khai bằng cách gửi nó cho xem xem lại:

  1. Đi tới trang OAuth 2.0 Apps .
  2. Nhấp vào nút Chỉnh sửa và Xuất bản cho ứng dụng bạn muốn xuất bản.
  3. Điền tất cả các thông tin yêu cầu và nhấp vào nút Xem và Xuất bản . Một thông điệp với giới hạn về quyền truy cập ứng dụng của bạn trong khoảng thời gian đang chờ đợi xem xét bản xét duyệt.
  4. Nhấp vào Gửi đi cho Đánh giá .

Trong khi đánh giá app của bạn đang chờ xử lý, bạn không thể chỉnh sửa hoặc gửi một yêu cầu khác cho đến khi yêu cầu đánh giá hiện tại được chấp nhận hoặc bị từ chối. Ứng dụng của bạn vẫn ở chế độ riêng tư trong khi đánh xem lại. Khi ứng dụng của bạn đượ

Bất kể việc xem xét app của bạn được chấp nhận hay bị từ chối, bạn đều nhận được thông báo email kết quả khi cuộc xem xét được hoàn thành.

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 bạn bằng các bước sau đây nếu nó không được xem xem lại:

  1. Đi tới trang OAuth 2.0 Apps .

  2. Nhấp vào Chỉnh sửa hoặc Xóa cho ứng dụng được yêu cầu.

    • Nếu bạn chọn để chỉnh sửa một ứng dụng, hãy thực hiện các bước và yêu cầu tương tự như đăng ký .
    • Nếu bạn chọn xóa một ứng dụng, hãy nhấp vào Vâng, 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ể lấy nó lại.

Điều chỉnh thông tin chung của ứng dụng của bạn hoặc đổi URL hướng tới không yêu cầu người dùng phải thẩm quyền lại app. Tuy nhiên, nếu bạn thêm hoặc chỉnh sửa phạm vi quyền truy cập, bạn phải nhận được sự cho phép từ người dùng củ

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