# Applicazioni partner
# Creare un account partner
Per poter pubblicare le tue applicazioni e temi per le organizzazioni presenti su Riseact, è necessario creare un account Partner. Segui i passaggi di seguito per creare il tuo account Partner:
1. Visita il sito web di Riseact e accedi alla pagina di registrazione tramite il seguente link: [https://accounts.riseact.org/signup/](https://accounts.riseact.org/signup/).
2. Una volta sulla pagina di registrazione, nella parte superiore destra della pagina, troverai l'icona del tuo avatar. Fai clic sull'icona per aprire il menu a tendina.
3. All'interno del menu a tendina, individua l'opzione "Diventa un partner" e selezionala.
4. Verrà visualizzata una schermata in cui dovrai inserire il nome del tuo profilo partner. Assicurati di scegliere un nome appropriato e rappresentativo.
5. Dopo aver inserito il nome del profilo partner, fai clic su "Attiva il profilo" per completare il processo di creazione dell'account Partner.
6. Una volta completati questi passaggi, avrai creato con successo il tuo account Partner su Riseact. Ora sarai in grado di pubblicare le tue applicazioni e temi per le organizzazioni presenti sulla piattaforma. Assicurati di seguire le linee guida e i requisiti specifici forniti da Riseact per garantire la conformità e la qualità delle tue pubblicazioni.
---
*Contenuto importato da [https://dev.riseact.org/docs/partner-apps/getting-started](https://dev.riseact.org/docs/partner-apps/getting-started) il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia.*
# Creare un'applicazione partner
Per poter interagire con le APIs di Riseact è necessario creare un applicazione. Segui i passaggi descritti in questa pagina per crearne una.
1. Accedi al tuo [account Riseact Partner](https://dev.riseact.org/docs/getting-started) su Riseact.
2. Una volta effettuato l'accesso, troverai un menu laterale. Seleziona "Applicazioni" per accedere alla sezione delle applicazioni.
3. Clicca su "Crea applicazione" per iniziare la creazione della tua nuova applicazione.
4. Ora dovrai inserire alcune informazioni di base sull'applicazione:
- **Nome**: Scegli un nome significativo per la tua applicazione.
- **Descrizione**: Fornisci una breve descrizione dell'applicazione per spiegare di cosa si tratta.
- **Tipo di distribuzione**: Seleziona "public" se desideri che l'applicazione sia disponibile per tutte le organizzazioni. Se preferisci che l'applicazione sia disponibile solo per organizzazioni selezionate, scegli "private".
- **Logo**: Puoi scegliere di caricare un logo per l'applicazione. Questo passaggio è facoltativo.
- **URL dell'applicazione**: Inserisci l'URL del sito web che verrà incorporato nell'admin di Riseact.
- **Homepage**: Inserisci l'URL della homepage del sito di dettaglio dell'applicazione. Assicurati di fornire informazioni dettagliate sull'applicazione per coinvolgere gli utenti. Questo URL verrà mostrato solo nella pagina dell'applicazione nello store.
- **Redirect URL per OAuth**: Questo è l'URL di reindirizzamento per il protocollo OAuth. Di solito è qualcosa come "[https://url-della-tua-app.it/oauth/callback"](https://url-della-tua-app.it/oauth/callback%22). Assicurati di inserire l'URL corretto per consentire l'autenticazione tramite OAuth.
5. Una volta completati tutti i campi richiesti, fai clic su "Salva" per salvare le modifiche e creare l'applicazione.
Seguendo questi passaggi, ti verranno forniti un `client_id` e `client_secret` che potrai utilizzare per ottenere un Access Token attraverso il processo di OAuth. Per ulteriori informazioni, consulta la prossima pagina [Autenticazione con OAuth](https://dev.riseact.org/docs/apps/oauth-authentication).
Una volta creata l'applicazione, potrai iniziare a sviluppare e distribuire l'applicazione su Riseact. Per semplicità, ti consigliamo di utilizzare la CLI di Riseact per creare e distribuire l'applicazione. Per maggiori informazioni, consulta la pagina [Panoramica della CLI](https://dev.riseact.org/docs/cli/overview).
---
*Contenuto importato da [https://dev.riseact.org/docs/partner-apps/create-application](https://dev.riseact.org/docs/partner-apps/create-application) il 2026-04-23 durante la migrazione iniziale della KB Metadonors. Aggiornare se il sorgente cambia.*
# Autenticazione con OAuth
L'implementazione dell'autenticazione OAuth è essenziale per ottenere un Access Token e poter utilizzare le API. Segui i passaggi di questa guida per comprendere il processo di OAuth e integrarlo correttamente nella tua applicazione.
1. **Comprendi il concetto di OAuth**: OAuth è un protocollo standard che consente di delegare l'autenticazione di un utente a un servizio terzo in modo sicuro. Il processo coinvolge tre attori principali: il client (la tua applicazione), il server di autorizzazione (Riseact Account) e il server di risorse (Riseact Core, che fornisce accesso alle APIs). OAuth garantisce che il client ottenga un Access Token valido per accedere alle risorse protette dal server a nome dell'organizzazione che installa l'applicazione.
2. **Registra la tua applicazione**: Prima di implementare l'autenticazione OAuth, è necessario [registrare la tua applicazione su Riseact Parnters](https://dev.riseact.org/docs/partner-apps/create-application) per ottenere le credenziali necessarie. Queste credenziali includono un Client ID e un Client Secret, che verranno utilizzati per identificare e autenticare la tua applicazione durante il processo di autorizzazione.
3. **Configura l'autenticazione nel tuo backend**: Nel tuo backend, dovrai implementare la logica per gestire il flusso di autorizzazione OAuth. Ciò comporta la creazione di un endpoint per l'autorizzazione che reindirizzerà l'utente al server di autorizzazione per l'autenticazione. Durante questa fase, dovrai includere il tuo Client ID e generare le chiavi PKCE che verranno utilizzate per scambiare il codice di autorizzazione nella callback e che quindi dovrai temporaneamente salvare. Quando un organizzazione installerà la tua applicazione su Riseact, dal pannello di amministrazione verrà visualizzato un iframe che punta all'url dell'app che hai indicato in fase di registrazione. Insieme all'url che hai fornito, verrà passato un parametro `__organization` che potrai utilizzare per identificare l'organizzazione che sta utilizzando la tua applicazione e saltare il roundtrip di selezione dell'organizzazione su Riseact Admin. Per farlo, dovrai reindirizzare l'utente al server di autorizzazione con un parametro `__organization` che contiene lo slug dell'organizzazione che hai ricevuto dal parametro `__organization` dell'url di reindirizzamento.
Ecco un esempio in node.js:
```
app.get('/oauth/authorize', (req, res) => {
const { codeChallenge, codeVerifier } = generatePkceKeys();
db.savePkceKey(codeChallenge, codeVerifier);
const params = {
client_id: "CLIENT_ID",
redirect_uri: 'https://your-app.com/oauth/callback',
response_type: 'code',
code_challenge_method: 'S256',
code_challenge: 'YOUR_CODE_CHALLENGE',
__organization: req.query.__organization,
};
res.redirect(`https://accounts.riseact.org/oauth/authorize/?${qs.stringify(params)}`);
});
```
```
curl -X GET \
"https://accounts.riseact.org/oauth/authorize/\
?client_id=CLIENT_ID\
&redirect_uri=https://your-app.com/oauth/callback\
&response_type=code\
&code_challenge_method=S256\
&code_challenge=YOUR_CODE_CHALLENGE\
&__organization=YOUR_ORGANIZATION"
```
```
app.get('/oauth/callback', async (req, res) => {
const { code, state } = req.query;
if (state !== 'YOUR_CODE_CHALLENGE') {
return res.status(400).send('Invalid state');
}
const { codeChallenge, codeVerifier } = await db.getPkceKey(state);
const formData = {
client_id: CLIENT_ID,
client_secret: CLIENT_SECRET,
grant_type: 'authorization_code',
code,
redirect_uri: 'https://your-app.com/oauth/callback',
code_verifier: codeVerifier,
};
const { data } = await axios.post('https://accounts.riseact.org/oauth/token/', qs.stringify(formData), {
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
},
});
db.saveCredentials(data.access_token, data.refresh_token, data.expires_in);
});
```
```
curl -X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET" \
-d "grant_type=authorization_code" \
-d "code=YOUR_CODE" \
-d "redirect_uri=https://your-app.com/oauth/callback" \
-d "code_verifier=YOUR_CODE_VERIFIER" \
https://accounts.riseact.org/oauth/token/
```
```
const { data } = await axios.get('https://core.riseact.org/admin/graphql/', {
headers: {
Authorization: `Bearer ${access_token}`,
},
});
```
```
curl -X GET \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
https://core.riseact.org/admin/graphql/
```
```
app.get('/oauth/refresh', async (req, res) => {
const { refresh_token } = req.query;
const formData = {
client_id: CLIENT_ID,
client_secret: CLIENT_SECRET,
grant_type: 'refresh_token',
refresh_token,
};
const { data } = await axios.post('https://accounts.riseact.org/oauth/token/', qs.stringify(formData), {
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
},
});
db.saveCredentials(data.access_token, data.refresh_token, data.expires_in);
});
```
```
curl -X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET" \
-d "grant_type=refresh_token" \
-d "refresh_token=YOUR_REFRESH_TOKEN" \
https://accounts.riseact.org/oauth/token/
```
```
Authorization: Bearer
```
```
{
"organization": "your-org-domain",
"object": {
"id": 75835,
"create_date": "2023-08-17T16:10:45.354192+00:00",
"update_date": "2023-08-17T16:10:45.367332+00:00",
"image": "",
"business_name": null,
"first_name": "first name",
"last_name": "last name",
"supporter_type": "SupporterType.INDIVIDUAL",
"email": "test@email.com",
"phone": "phone",
"mobile": "mobile",
"sex": "Sex.MALE",
"date_of_birth": "1970-01-01",
"place_of_birth": "Place of birth",
"ssn": "ssn",
"vat": "vat",
"address": "address",
"address2": "secondary address",
"city": "city",
"locality": "locality",
"country": "IT",
"postal_code": "code",
"certification_url": null,
"privacy": false,
"email_marketing": false,
"phone_marketing": false,
"sms_marketing": false,
"postal_marketing": false,
"note": "notes",
"tags": [],
"external_ref": null,
"source_campaign": null,
"organization": 33,
"application": 1,
"stripe_customer_id": null
},
"event": "supporter.created"
}
```
```
{
"organization": "your-org-domain",
"object": {
"id": 901,
"create_date": "2023-08-17T16:15:52.746141+00:00",
"update_date": "2023-08-17T16:15:52.746165+00:00",
"state": "OPEN",
"amount": 10,
"completed_date": null,
"donation": null,
"supporter": 75835,
"frequency": null,
"peer_campaign": null
},
"event": "checkout.created"
}
```
```
{
"organization": "your-org-domain",
"object": {
"id": 230,
"create_date": "2023-08-17T16:27:04.647182+00:00",
"update_date": "2023-08-17T16:27:04.647204+00:00",
"state": "PAID",
"amount": 10,
"payment_date": "2023-08-17T16:26:59.889000+00:00",
"payment_method": "MANUAL",
"donation": 229,
"supporter": 75835,
"frequency": 0,
"peer_campaign": null
},
"event": "payment.created"
}
```
```
{
"organization": "your-org-domain",
"object": {
"id": 229,
"create_date": "2023-08-17T16:27:04.542168+00:00",
"update_date": "2023-08-17T16:27:04.542168+00:00",
"code": "#1000",
"state": "pending",
"amount": 10,
"frequency": 0,
"completed_date": null,
"campaign": 29,
"peer_campaign": null,
"supporter": 75835,
"tags": [],
"payment_method": "MANUAL"
},
"event": "donation.created"
}
```