Login With Haravan

Appearance

Cấu hình Tích hợp ​

1. Frappe Site Config ​

Bạn cần cung cấp Client ID và Secret cho Frappe Site. Truy cập Frappe Cloud > Site > Site Config > Add Config > Custom Key.

  • Config name:
    text
    haravan_account_login
  • Value:
    json
    {
  "client_id": "HARAVAN_CLIENT_ID",
  "client_secret": "HARAVAN_CLIENT_SECRET"
}

haravan_account_login là key ưu tiên vì Frappe core đọc theo quy ước {provider}_login với provider là haravan_account. App vẫn hỗ trợ haravan_login và hai key rời haravan_client_id / haravan_client_secret để tương thích ngược, nhưng không nên dùng cho cấu hình mới.

Các token/secret khác của Helpdesk cũng nên đặt ở Site Config thay vì Settings DocType:

text
gemini_api_key
gemini_model
openrouter_api_key
bitrix_webhook_url
bitrix_access_token
bitrix_refresh_token
bitrix_client_id
bitrix_client_secret
bitrix_base_url
bitrix_domain
bitrix_enabled
bitrix_timeout_seconds
bitrix_refresh_ttl_minutes

Runbook bàn giao chi tiết: docs/SITE_CONFIG_HANDOFF.md.

2. Social Login Key ​

Đảm bảo DocType Social Login Key có cấu hình như sau:

  • DocType: Social Login Key
  • Social Login Provider: Custom
  • Provider Name: Haravan Account
  • Enable Social Login: Được tích chọn
  • Client ID: HARAVAN_CLIENT_ID
  • Client Secret: để trống nếu haravan_account_login đã có client_secret
  • Base URL: https://accounts.haravan.com
  • Custom Base URL: Được tích chọn
  • Authorize URL: /connect/authorize
  • Access Token URL: /connect/token
  • Redirect URL: /api/method/login_with_haravan.oauth.login_via_haravan
  • API Endpoint: /connect/userinfo
  • User ID Property: sub
  • Sign ups: Allow

Auth URL Data:

json
{
  "response_mode": "query",
  "response_type": "code",
  "scope": "openid profile email org userinfo"
}

3. Haravan Partner Dashboard ​

Trên ứng dụng Public / Custom bên trong Haravan Partner Dashboard, bạn phải điền chính xác đường dẫn Redirect URL:

text
https://haravandesk.s.frappe.cloud/api/method/login_with_haravan.oauth.login_via_haravan

Lưu ý: Client ID và Client Secret ở Site Config phải được lấy ra từ ứng dụng chứa Redirect URL này. Không lưu plaintext secret trong Settings DocType sau khi smoke test production đã pass.