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

# Collegare Smoobu: Api Key + Secret (HMAC)

> Perché la sola Api Key di Smoobu non basta più, dove trovare Api Key e Secret nel pannello, e come inserirli in Connessioni.

Smoobu ha due modalità di autenticazione per le sue API: una **chiave semplice** (un solo valore, nell'header `Api-Key`) e una **firmata** (HMAC: Api Key + Secret, usati insieme per calcolare una firma ad ogni richiesta). Fino a poco tempo fa la piattaforma Mattone collegava Smoobu con la sola chiave semplice. Non è più così: alcuni account Smoobu sono già passati alla modalità firmata, e la chiave semplice da sola viene rifiutata su quegli account. Smoobu ritira comunque la modalità a chiave semplice entro fine mese, quindi la richiesta vale per tutti, non solo per chi è già passato.

<Warning>
  Se il collegamento Smoobu di uno studente viene rifiutato con un errore di autenticazione pur avendo inserito correttamente l'Api Key, la causa più probabile è questa: quell'account richiede ormai anche il **Secret**. Non è un problema della piattaforma — è Smoobu che ha cambiato requisito per quell'account.
</Warning>

## Dove si trovano Api Key e Secret

Entrambi i valori si recuperano dal pannello Smoobu dello studente, nella stessa pagina:

<Steps>
  <Step title="Impostazioni → Profilo">Nel pannello Smoobu dello studente, sezione **Impostazioni → Profilo**. Qui è mostrata l'**Api Key** dell'account.</Step>
  <Step title="Genera Secret">Nella stessa pagina c'è un pulsante per generare l'**Api Secret**. Se non è mai stato generato prima, premendolo se ne crea uno nuovo. Vanno copiati **entrambi** i valori: servono insieme, non uno dei due.</Step>
</Steps>

<Note>Se il Secret era già stato generato in passato e nessuno lo ha salvato, va rigenerato: Smoobu non lo mostra una seconda volta.</Note>

## Come si collega

Lo studente inserisce entrambi i valori in **/connessioni** della piattaforma, scheda Smoobu: il form chiede ora due campi (Api Key e Api Secret), non più uno solo. Al salvataggio la piattaforma calcola la firma HMAC e fa una chiamata reale a Smoobu per verificare che i due valori siano corretti e coerenti **prima** di scriverli: un tentativo rifiutato non sovrascrive una connessione che oggi funziona.

<CardGroup cols={2}>
  <Card title="Collega Smoobu (piattaforma)" icon="arrow-up-right-from-square" href="https://app.mattone.co/connessioni">Inserisci Api Key + Api Secret</Card>
  <Card title="Pannello Smoobu → Impostazioni → Profilo" icon="key">Api Key e pulsante "Genera Secret"</Card>
</CardGroup>


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