> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticació

> Trieu una clau d'API o les credencials de client d'OAuth per a la vostra integració i enteneu com utilitza cadascuna un compte de servei.

**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](/ca/developers/v1/quickstart). 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

| Element | Finalitat | Què envia la vostra integració |
| - | - | - |
| **Service account** | Dona nom a la càrrega de treball i defineix el seu límit de permisos. | El seu ID identifica el compte; no autentica una sol·licitud. |
| **API key** | S'autentica directament com a aquest compte de servei, amb un conjunt de permisos i una caducitat determinats. | El secret de la clau mitjançant l'autenticació HTTP Basic o `Authorization: Bearer <api_key_secret>`. |
| **OAuth client** | S'autentica davant d'un servei de testimonis per obtenir testimonis d'accés amb àmbit limitat per a aquest compte de servei. | Un testimoni d'accés mitjançant `Authorization: Bearer <access_token>`. |

Creeu un [compte de servei](/ca/developers/developer-hub/service-accounts) 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](/ca/developers/v1/quickstart) i consulteu després
[API keys](/ca/developers/developer-hub/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](/ca/developers/v1/oauth) 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](/ca/developers/v1/regions) 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ó.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.