WordPress webhely kulcsa

Az AstroWay WordPress bővítmény maga szerzi be a kulcsot, regisztráció nélkül: a webhely a REST útvonalán mutatja be a bizonyítékot, mi ellenőrizzük, és kiadunk egy kulcsot, amely ehhez a webhelyhez van kötve.

Hogyan történik az ellenőrzés

1. A bővítmény generál egy proof_id-t (UUID v4) és egy proof-ot (32 véletlenszerű bájt base64url formátumban, 43 karakter), és 10 percig tárolja őket.
2. A webhely GET <home_url>/wp-json/astroway/v1/verify?nonce=<proof_id> kérést ad vissza Content-Type: application/json fejléccel és {"proof":"<proof>"} törzzsel.
3. A bővítmény POST /v1/site-keys kérést küld:

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

site_url pontosan home_url(), ? és # nélkül. Egyszerű permalinkek esetén add meg a verify_url-t ?rest_route=/astroway/v1/verify paraméterrel: ez csak ugyanazon a webhelyen és csak ezen az útvonalon fogadható el.

Mit ad a kulcs

• a webhely szerverének: a böngészőből érkező kérés (az Origin fejléccel) 403-at kap, és minden hívásnak meg kell neveznie a webhelyet az X-AstroWay-Site-URL fejlécben. A kötés ezen a fejlécen alapul, ezért a kulcsot titokban kell tartanod, és ha kiszivárog, szerezz be egy újat: az előzőt visszavonjuk;
• ingyenes olvasások készlete, 300 hívás óránként webhelyenként, kreditek nélkül; a dátummal ellátott horoszkópok csak a mai dátum közelében fogadhatók el;
• egy kulcs telepítésenként (hoszt és kezdőútvonal), akár 5 telepítés hosztonként, közös órával.

Hibák: 400 INVALID_SITE_URL, 422 SITE_VERIFICATION_FAILED details.reason paraméterrel, 429 SITE_KEY_RATE_LIMIT retry_after paraméterrel.

Fiók csatlakoztatása

Amikor a webhely tulajdonosa a saját csomagján szeretne dolgozni, a bővítmény egy kattintással átállítja a webhelyet a fiókkulcsra.

1. A bővítmény megnyitja az adminisztrátor böngészőjében a https://api.astroway.info/dashboard/connect?site=<home_url>&return=<admin_url>&state=<16-128 karakter>&source=wp_plugin címet. A return paraméternek ugyanazon a hoszton kell lennie, mint a site paraméternek, és https-nek kell lennie.
2. Az adminisztrátor bejelentkezik vagy regisztrál, és kiválaszt egy kulcsot a webhelyhez, vagy létrehoz egy újat. Egy már másik domainhez kötött kulcs csak külön megerősítés után vihető át.
3. A böngésző visszatér a return címre a code és ugyanaz a state paraméterrel. A megszakítás error=access_denied hibát ad vissza.
4. A webhely szervere kicseréli a kódot, elküldve a webhely kulcsát az X-Api-Key fejlécben:

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

Válasz: { "key": "aw_live_…", "plan": "free", "domain": "example.com", "account": "j***@example.com" }. A kód 5 percig él. Ugyanazon kód ismételt cseréje ugyanazzal a webhelykulccsal 10 percen belül ugyanazt a választ adja vissza. A webhelykulcs 24 órával a csere után érvénytelenné válik.

Hibák: 400 INVALID_CODE, 410 CODE_EXPIRED, 403 SITE_MISMATCH.