Applicazioni private
Un'applicazione privata accede alle API di Riseact con un token statico, senza flusso OAuth. È pensata per script, integrazioni tra backend e strumenti interni.
Creare un'applicazione privata
- Nel pannello di amministrazione vai su Impostazioni > App > Applicazioni private.
- Clicca Nuova applicazione privata.
- Dai un nome, per esempio "Sync CRM".
- Seleziona i permessi.
- Clicca Crea.
Il token di accesso viene mostrato una sola volta: copialo subito. È legato all'organizzazione e non scade.
Attenzione: Tratta il token come una password: non metterlo nel codice versionato.
Usare il token
Il token va in ogni richiesta, nell'header Authorization, sia per GraphQL sia per REST:
Authorization: Bearer <IL_TUO_TOKEN>GraphQL
curl -X POST https://core.riseact.org/admin/graphql/ \
-H "Authorization: Bearer IL_TUO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"query": "query { organization { name domain } }"}'REST
curl https://core.riseact.org/api/v1/supporters/ \
-H "Authorization: Bearer IL_TUO_TOKEN"Paginazione e ordinamento: vedi Paginazione REST.
Permessi
L'applicazione accede solo alle risorse per cui ha i permessi, nel formato entità:azione.
| Permesso | Descrizione |
|---|---|
supporter:read | Lettura dei sostenitori |
supporter:write | Creazione e modifica dei sostenitori |
supporter:export | Esportazione dei sostenitori |
donation:read | Lettura delle donazioni |
donation:write | Creazione e modifica delle donazioni |
donation:export | Esportazione delle donazioni |
payment:read | Lettura dei pagamenti |
payment:write | Creazione e modifica dei pagamenti |
campaign:read | Lettura delle campagne |
campaign:write | Creazione e modifica delle campagne |
project:read | Lettura dei progetti |
project:write | Creazione e modifica dei progetti |
activity:read | Lettura delle attività |
activity:write | Creazione e modifica delle attività |
reports:read | Accesso ai report |
application:read | Lettura delle applicazioni installate |
application:install | Installazione di applicazioni |
sitefront:themes | Gestione dei temi del sito |
sitefront:themes.code | Modifica del codice dei temi |
sitefront:content | Gestione dei contenuti del sito |
sitefront:navigation | Gestione della navigazione del sito |
dbox:read | Lettura delle donation box |
dbox:write | Creazione e modifica delle donation box |
Senza il permesso richiesto dall'operazione, la risposta è un errore di autorizzazione. :write non include :read: per leggere e scrivere i sostenitori servono sia supporter:read sia supporter:write.
Rigenerare il token
Se il token è compromesso, rigeneralo da Impostazioni > App > Applicazioni private: il precedente smette subito di funzionare.
Differenza rispetto alle partner app
| Caratteristica | Applicazione privata | Partner app |
|---|---|---|
| Accesso | Singola organizzazione | Tutte le org che installano l'app |
| Autenticazione | Token statico, nessuna scadenza | OAuth 2.0 con PKCE, token temporanei |
| Gestione token | Manuale da admin | Automatica tramite refresh token |
| Caso d'uso tipico | Automazioni interne, script | Integrazioni di terze parti |
Fonte: https://dev.riseact.org/docs/private-apps/getting-started. Copia automatica da dev.riseact.org: non modificare qui, le modifiche vanno fatte sulla documentazione Docusaurus.