Ihr externes CRM mit der B2COPY API integrieren

Autorisieren Sie Anfragen von Ihrem externen CRM an den B2COPY API mithilfe eines Dienstadministrators und signierten JWT-Tokens (ES256). Auf dieser Seite werden die Voraussetzungen, die Schlüsselgenerierung, die Token-Ausgabe und das Erhalten/Aktualisieren von B2COPY-Tokens behandelt.

Voraussetzungen

• Erstellen Sie im Admin-Bereich einen Dienstadministrator, in dessen Namen der CRM API-Anfragen stellt (es wird empfohlen, ihn auf bestimmte IP-Adressen zu beschränken).
• Konfigurieren Sie Ihren CRM, um signierte JWTs zu generieren, deren Ansprüche admin_id (die Dienstadministrator-ID), device_ip (die Anforderung IP) und key_id (die private Schlüssel-ID) umfassen.

Schlüssel generieren

Generieren Sie ein Schlüsselpaar EC (P-256) zum Signieren und Überprüfen von Token:

# Private key
openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256 \
  -out ec_private_pkcs8.pem

# Public key
openssl pkey -in ec_private_pkcs8.pem -pubout -out ec_public.pem

Kontaktieren sie den B2COPY-support

Um die Integration abzuschließen, senden Sie dem Support-Team Ihren öffentlichen Schlüssel (ec_public.pem), die eindeutige Schlüsselkennung und die IP-Adressen, die API aufrufen. Der Support registriert Ihre Integration und konfiguriert den öffentlichen Schlüssel.

Erhalten sie zugriffs- und aktualisierungstoken

POST [host]/api/admin/auth/v2/admin/adminservice/authexternalcrm

curl -X POST "[host]/api/admin/auth/v2/admin/adminservice/authexternalcrm" \
  -d '{ "external_token": "<your-generated-jwt-token>" }'

Die Antwort gibt Zugriffs- und Aktualisierungstokens für den Dienstadministrator zurück; Fügen Sie das Zugriffstoken in den Header Authorization aller anderen Anforderungen ein.

{
  "accessToken": "<access-token>",
  "refreshToken": "<refresh-token>"
}

Aktualisieren sie das zugriffstoken

POST [host]/api/admin/auth/v2/admin/adminservice/refreshtoken

curl -X POST "[host]/api/admin/auth/v2/admin/adminservice/refreshtoken" \
  -H "Authorization: Bearer <refreshToken>"

Gibt ein neues Zugriffs-/Aktualisierungstokenpaar zurück.