Thiết lập API V8

Estimated reading: 2 minutes 342 views

1. Yêu cầu

  • Đã cài đặt và cấu hình OpenSSL PHP Extension.
  • Phải được cấu hình HTTPS/SSL.
  • PHP version 5.5.9, or 7.0 hoặc lớn hơn.

2. JSON API

– Trước khi bắt đầu gọi endpoints hãy kiểm tra và thiết lập các phần sau:

  • Cài đặt Composer: composer install
  • Tạo private và public.key cho OAUTH2
    • Mở terminal và đi đến {{suitecrm.root}}/Api/V8/OAuth2
    • Tạo private key: openssl genrsa -out private.key 2048
    • Tạo public key: openssl rsa -in private.key -pubout -out public.key
    • Phân quyền 600 hoặc 660 cho 2 file key này:
      • sudo chmod 600 private.key public.key
      • sudo chown www-data:www-data p*.key
  • Có thể tạo mới key mã hóa OAUTH2 (Optional)
    • AuthorizationServer của OAuth2 cần thiết lập khóa mã hóa vì lý do bảo mật. Khóa này đã được tạo trong quá trình cài đặt BM và được lưu trữ trong config.php ở phần “oauth2_encryption_key“.
    • Nếu muốn thay đổi giá trị của nó, có thể tạo một key mới bằng cách chạy: php -r ‘echo base64_encode(random_bytes(32)), PHP_EOL;’
    • Sau đó copy key trả về và dán vào oauth2_encryption_key ở config.php

3. Authentication 

BM cho phép 2 loại grant types:

  • Password
  • Client credential
ParameterMô tả
Access Token URL{{suitecrm.url}}/Api/access_token

4. Tham khảo thêm

CONTENTS