---
title: Getting Started
description: Account, Account API Key e il modello di autenticazione a due livelli per le integrazioni Audin.
---

Questa pagina introduce i concetti di base che ti servono prima di usare le API
REST partner o l'Operator SDK: cos'è un Account, cos'è l'Account API Key e come
funziona il modello di autenticazione a due livelli.

## L'Account Audin

Ogni integrazione è collegata a un **Account** Audin: è l'entità che racchiude i
tuoi dati (leads, deals, attività, numeri, operatori) e le tue configurazioni.
Tutte le chiamate alle API partner operano nel contesto del tuo Account.

## L'Account API Key

L'**Account API Key** è la credenziale che identifica e autorizza il tuo Account
verso le API REST partner. La presenti nell'header `X-API-Key`:

```http
GET /leads HTTP/1.1
Host: api.audin.ai
X-API-Key: aud_acc_xxxxxxxxxxxxxxxx
```

<Callout type="warn">
  L'Account API Key è un **segreto**: dà pieno accesso ai dati del tuo Account.
  Tienila **solo sul tuo backend**, mai nel browser, nelle app mobili o in
  qualsiasi codice client. Non includerla nei repository pubblici.
</Callout>

## Modello di autenticazione a due livelli

Alcune funzionalità — in particolare l'Operator SDK — girano **nel browser**,
dove un segreto non può vivere in sicurezza. Per questo Audin usa un modello a
due livelli:

<Steps>
<Step>
**Lato server (segreto).** Il tuo backend custodisce l'Account API Key e la usa
per parlare con le API Audin. La chiave non lascia mai il tuo server.
</Step>

<Step>
**Token effimero per il client.** Quando un client (browser/SDK) ha bisogno di
operare, chiama un endpoint del **tuo** backend. Il tuo backend, autenticandosi
con l'Account API Key, richiede ad Audin un **token effimero** a vita breve e lo
restituisce al client.
</Step>

<Step>
**Il client usa solo il token.** Il browser/SDK si autentica con il token
effimero, mai con l'Account API Key. Quando il token sta per scadere, il client
ne richiede uno nuovo passando di nuovo dal tuo backend.
</Step>
</Steps>

In forma schematica:

```text
Browser / SDK ──(1) richiesta token──▶ Il tuo backend ──(2) X-API-Key──▶ Audin API
      ▲                                       │
      └──────────(3) token effimero───────────┘

Browser / SDK ──(token effimero)──▶ Audin   (operatività: presenza, chiamate, …)
```

Questo separa nettamente il segreto (Account API Key, lato server) dalla
credenziale operativa di breve durata (token effimero, lato client). Il dettaglio
del flusso token per gli operatori è descritto nella sezione
[Operator SDK](/docs/operator-sdk).

## Dove ottenere le credenziali

L'Account API Key viene fornita per il tuo Account in fase di onboarding. Se non
sai dove reperirla o devi ruotarla, contatta il tuo referente Audin.

<Callout type="warn">
  Ribadiamo: l'Account API Key non va **mai** esposta nel browser. Nel client
  circola esclusivamente il token effimero ottenuto tramite il tuo backend.
</Callout>