Skip to main content
No necessiteu OAuth per utilitzar la Public API. Per a una integració privada del costat del servidor, comenceu amb una clau d’API amb àmbit limitat i seguiu la guia d’inici ràpid. Trieu les credencials de client d’OAuth quan la vostra política de seguretat requereixi testimonis d’accés de curta durada o quan la vostra plataforma d’integració ja admeti aquest flux. Totes dues opcions utilitzen un compte de servei. Un compte de servei és la identitat de la integració, no un tercer mètode d’autenticació.

​
Com encaixen les peces

Creeu un compte de servei per integració. Trieu una clau d’API o un client d’OAuth per a aquest compte; no necessiteu tots dos mètodes en cada sol·licitud d’API. Cap de les dues credencials pot superar els permisos actuals del compte. La guia d’inici ràpid utilitza l’autenticació Basic. També s’admet una capçalera Bearer per a les claus d’API; utilitzar aquesta capçalera no vol dir que necessiteu un client d’OAuth.

​
Trieu una clau d’API per a una integració senzilla

Utilitzeu una clau d’API per als vostres propis treballs programats, scripts d’informes, canalitzacions de dades o altres serveis de backend quan un secret emmagatzemat al vostre gestor de secrets s’ajusti als vostres requisits de seguretat.
  • Feu sol·licituds autenticades directament; no cal cap intercanvi de testimonis.
  • Seleccioneu només els permisos que necessita la càrrega de treball i definiu una caducitat.
  • Renoveu la clau mitjançant la seva finestra de solapament o revoqueu-la immediatament si s’ha exposat.
Una integració amb clau d’API no necessita un client d’OAuth. Comenceu amb la guia d’inici ràpid i consulteu després API keys per a la creació i la renovació.

​
Trieu OAuth per a testimonis d’accés de curta durada

Utilitzeu les credencials de client d’OAuth per a un servei de backend confidencial quan la vostra organització requereixi testimonis d’accés que caduquin o quan una eina d’integració esperi la concessió client_credentials.
  1. Creeu un client d’OAuth amb àmbit limitat per al compte de servei.
  2. Autentiqueu el client al punt final de testimonis de la vostra regió mitjançant el mètode d’autenticació de client facilitat durant la configuració.
  3. Envieu el testimoni d’accés obtingut amb les vostres sol·licituds d’API. Obteniu un testimoni nou abans que caduqui l’actual.
OAuth afegeix a la vostra integració l’obtenció de testimonis i la gestió de la seva caducitat. El secret del client continua requerint un emmagatzematge i una renovació segurs; els testimonis de curta durada no eliminen aquesta responsabilitat. Les credencials de client no utilitzen testimonis d’actualització: autentiqueu el client de nou per obtenir un nou testimoni d’accés. L’accés a OAuth s’ha d’habilitar per a la vostra organització. Si no està habilitat, utilitzeu una clau d’API o contacteu amb el Suport de Living Security per exposar les vostres necessitats. Consulteu OAuth client credentials per a la creació de clients, els secrets d’un sol ús, la revocació i la recuperació.

​
Mantingueu les credencials al backend

Les claus d’API dels comptes de servei i els secrets dels clients d’OAuth han d’estar en un emmagatzematge de secrets del costat del servidor. No els poseu al codi del navegador, a aplicacions mòbils, al control de versions ni als registres. Una credencial de compte de servei actua com a càrrega de treball; no inicia la sessió d’una persona ni ofereix un flux de consentiment del client. Utilitzeu l’amfitrió d’API regional de la vostra organització amb qualsevol dels dos mètodes. Canviar de mètode d’autenticació no canvia l’URL del recurs, la versió de l’API ni els permisos que requereix una operació.