MQTT
Pub/sub tramite MQTT nel namespace della tua organizzazione, con JWT o credenziali statiche
Ultimo aggiornamento il
Le credenziali MQTT danno alle integrazioni accesso pub/sub nel namespace dei topic della tua organizzazione. Crei le credenziali in Tillor sotto Account > Sviluppatori (per organizzazione). L'accesso ai topic è limitato a tillor/{env}/{orgId}/integration e ai sotto-topic ({env} = prod, staging o local), a meno che una credenziale statica abbia topicPrefix: null.
Per gli stessi eventi in tempo reale dei webhook e di SSE usa quei canali, non MQTT.
Gestione
| Metodo | Percorso | Descrizione |
|---|---|---|
| POST | /api/orgs/:orgId/mqtt/credentials | Genera credenziali JWT (temporanee) |
| GET | /api/orgs/:orgId/mqtt/static-credentials | Recupera le credenziali statiche |
| POST | /api/orgs/:orgId/mqtt/static-credentials | Crea una credenziale statica |
| DELETE | /api/orgs/:orgId/mqtt/static-credentials/:id | Elimina una credenziale statica |
Autenticazione: x-api-key, con l'ID dell'organizzazione nel percorso (come per l'API HTTP). Per gli schemi completi di richiesta e risposta vedi la specifica OpenAPI.
Credenziali
Esistono due varianti:
JWT (temporaneo)
- Uso: sessioni brevi, accesso temporaneo
- Scadenza: per impostazione predefinita 1 ora; configurabile da 1 minuto a 24 ore tramite
expiresInSeconds - Ideale per: test, connessioni temporanee, o quando recuperi i token dinamicamente
- Creazione: in Tillor sotto Account > Sviluppatori, oppure tramite
POST /api/orgs/:orgId/mqtt/credentialscon, facoltativamente,{ "clientId": "...", "expiresInSeconds": 3600 } - Risposta:
token(da usare come password MQTT),clientId,brokerUrl,topicPrefix,expiresAt - Nome utente: lascialo vuoto quando ti colleghi; l'autenticazione JWT usa solo il token come password.
- Client ID: quando ti colleghi usa esattamente il
clientIddella risposta (incluso il prefisso dell'ambiente, ad es.prod-).
Una connessione al broker tramite mqtts verifica il certificato del server. Se usi un certificato CA privato (non la normale catena pubblica), inserisci il PEM di quella CA nell'ambiente del tuo client.
Credenziali statiche
- Uso: integrazioni di lunga durata, connessioni sempre attive
- Forma: userName, clientId e password fissi
- Ideale per: integrazioni di produzione che restano collegate in continuazione
- Creazione: in Tillor sotto Account > Sviluppatori, oppure tramite
POST /api/orgs/:orgId/mqtt/static-credentialscon, facoltativamente,{ "name": "mijn-integratie", "topicPrefix": null } - Risposta:
userName,clientId,password(una sola volta),topicPrefix(null= nessun prefisso, ACL#), facoltativamentebrokerUrl - Attenzione: la password viene mostrata una sola volta nella risposta e non può essere recuperata in seguito
Accesso ai topic
Le sottoscrizioni ai topic sono strettamente limitate, a meno che topicPrefix sia null (ACL #). Per impostazione predefinita puoi pubblicare e sottoscrivere solo su tillor/{env}/{orgId}/integration e tillor/{env}/{orgId}/integration/#.
- Topic consentiti - solo
tillor/{env}/{orgId}/integratione i sotto-topic (ad es.tillor/{env}/{orgId}/integration/connector/access-point-operation) - Nessun bypass con wildcard - anche con
#o+ottieni accesso solo al namespace della tua organizzazione - Per organizzazione - le credenziali valgono per organizzazione; non hai accesso ai topic di altre organizzazioni