Khóa trang web cho WordPress

Quy trình xác minh

1. Plugin tạo ra proof_id (UUID v4) và proof (32 byte ngẫu nhiên ở base64url, 43 ký tự) và giữ chúng trong 10 phút.
2. Trang web gửi GET <home_url>/wp-json/astroway/v1/verify?nonce=<proof_id> với Content-Type: application/json và nội dung {"proof":"<proof>"}.
3. Plugin gửi POST /v1/site-keys:

{ "site_url": "https://example.com", "proof_id": "3f1c2a9e-8b7d-4c1e-9f3a-2b6d5e4c1a07", "proof": "<43 characters>" }

site_url chính xác là home_url(), không có ? và #. Đối với các liên kết đơn giản và cố định, hãy chuyển verify_url với ?rest_route=/astroway/v1/verify: nó chỉ được chấp nhận trên cùng một trang web và chỉ như tuyến đường này.

Điều mà khóa cung cấp

• cho máy chủ trang web: yêu trình từ trình duyệt (với tiêu đề Origin) nhận được 403, và mỗi cuộc gọi phải chỉ định trang web trong X-AstroWay-Site-URL. Liên kết được duy trì trên tiêu đề này, vì vậy hãy lưu khóa như một bí mật, và nếu nó bị rò rỉ, hãy nhận một cái mới: cái trước sẽ bị thu hồi;
• bộ đọc miễn phí, 300 cuộc gọi mỗi giờ trên mỗi trang web, không có tín dụng; tử vi với ngày chỉ được chấp nhận gần ngày hiện tại;
• một khóa cho mỗi cài đặt (host và đường dẫn home), lên đến 5 cài đặt trên host với giờ chung.

Lỗi: 400 INVALID_SITE_URL, 422 SITE_VERIFICATION_FAILED với details.reason, 429 SITE_KEY_RATE_LIMIT với retry_after.

Kết nối tài khoản

Khi chủ trang web muốn làm việc trên gói của họ, plugin chuyển trang web sang khóa tài khoản chỉ bằng một cú nhấp chuột.

1. Plugin mở trong trình duyệt quản trị viên https://api.astroway.info/dashboard/connect?site=<home_url>&return=<admin_url>&state=<16-128 ký tự>&source=wp_plugin. return phải trên cùng host với site, và trên https.
2. Quản trị viên đăng nhập hoặc đăng ký và chọn khóa cho trang web hoặc tạo mới. Khóa đã được liên kết với tên miền khác chỉ được chuyển sau khi có xác nhận riêng.
3. Trình duyệt quay trở lại return với code và cùng state. Hủy bỏ trả về error=access_denied.
4. Máy chủ trang web đổi mã, bằng cách gửi khóa trang web của mình trong X-Api-Key:

POST /v1/site-keys/connect/exchange
{ "code": "<43 characters>", "site_url": "https://example.com" }

Phản hồi: { "key": "aw_live_…", "plan": "free", "domain": "example.com", "account": "j***@example.com" }. Mã sống trong 5 phút. Việc đổi lại cùng một mã bằng cùng một khóa trang web trong vòng 10 phút trả về cùng một phản hồi. Khóa trang web hết hiệu lực sau 24 giờ từ khi đổi.

Lỗi: 400 INVALID_CODE, 410 CODE_EXPIRED, 403 SITE_MISMATCH.