Gancio in linea
Gli hook inline sono chiamate in uscita da miniOrange a un codice personalizzato/servizio esterno/applicazione, attivate durante i flussi di processo di miniOrange. Sono progettati per integrare perfettamente le funzionalità personalizzate. In particolare, miniOrange invia esclusivamente la risposta SSO all'hook inline, consentendo al tuo codice personalizzato di modificare questa risposta prima di restituirla a miniOrange. Questi hook utilizzano chiamate sincrone, sospendendo temporaneamente il processo miniOrange che ha avviato l'hook fino a quando non viene ricevuta una risposta dal servizio esterno.
Questo codice personalizzato dovrebbe essere implementato come un servizio Web con un endpoint accessibile da Internet. Deve essere ospitato su un sistema esterno a miniOrange. miniOrange definisce il contratto REST API per le richieste inviate al codice personalizzato e per le risposte dal codice personalizzato.
Passaggi per l'installazione del miniOrange Inline Hook
- Vai su Flusso di lavoro > Hook in linea.
- Fare clic su Aggiungi nuovo hook.
- Dal App dal menu a discesa, seleziona l'app per la quale desideri richiamare l'hook inline.
- Per creare Inline Hook sono necessari i seguenti dettagli:
- URL del gancio in linea: L'URL dell'endpoint fornito dal servizio esterno con cui vuoi effettuare l'integrazione. Questo URL è dove miniorange invierà le richieste HTTP.
- Richiesta HTTP: miniOrange costruirà una richiesta HTTP da inviare all'endpoint dell'hook inline. Questa richiesta in genere include il metodo di richiesta (POST, GET, PUT, DELETE), le intestazioni e il corpo richiesti dal servizio hook inline. Il metodo di richiesta e le intestazioni possono variare a seconda dei requisiti specifici dell'hook inline.
- Autenticazione: Gli hook inline in miniOrange si basano su meccanismi di autenticazione per proteggere la comunicazione tra miniOrange e il codice personalizzato. Ecco una ripartizione delle tre opzioni:
- Autenticazione di base: Questo è un semplice metodo di autenticazione in cui fornisci una combinazione di nome utente e password. miniOrange codifica queste informazioni utilizzando la codifica Base64 e le invia nell'intestazione Authorization di ogni richiesta al tuo endpoint hook inline. Il servizio esterno deve essere in grado di decodificare l'intestazione e convalidare il nome utente e la password per garantire l'accesso autorizzato.
- Intestazione HTTP: Questo metodo offre maggiore flessibilità e sicurezza rispetto all'autenticazione di base. Definisci un nome di intestazione personalizzato (ad esempio, X-Api-Key) e un valore segreto corrispondente nella configurazione dell'hook inline miniOrange. miniOrange include quindi questa intestazione con il valore segreto in ogni richiesta al tuo endpoint. Il tuo codice deve verificare la presenza di questa intestazione e convalidare il valore segreto per l'autorizzazione.
- Nessuna autenticazione: Questa opzione salta qualsiasi passaggio di autenticazione. miniOrange invia richieste all'endpoint del tuo hook inline senza alcuna credenziale.
- Clicchi Invio.
