Integrazione con hook del servizio
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Gli hook del servizio consentono di eseguire attività su altri servizi quando si verificano eventi nel progetto in Azure DevOps.
Ad esempio, è possibile creare una scheda in Trello quando viene creato un elemento di lavoro o inviare una notifica push ai dispositivi mobili del team in caso di errore di compilazione. È anche possibile usare hook di servizio in app e servizi personalizzati come modo più efficiente per guidare le attività quando si verificano eventi nei progetti.
Come funzionano gli hook del servizio?
Gli autori di hook del servizio definiscono un set di eventi a cui è possibile eseguire la sottoscrizione. Le sottoscrizioni sono in ascolto di questi eventi e definiscono le azioni da intraprendere in base all'evento.
Le sottoscrizioni sono destinate anche ai consumer, che sono servizi esterni che possono eseguire le proprie azioni quando si verificano eventi.
Nota
Gli hook del servizio richiedono l'autorizzazione degli intervalli IP per la connessione in ingresso agli endpoint di servizio. L'endpoint del servizio è il set di proprietà fornite a un hook del servizio. Per altre informazioni, vedere Elenchi di indirizzi consentiti e connessioni di rete, indirizzi IP e restrizioni di intervallo.
Servizi disponibili
I servizi seguenti sono disponibili come destinazione degli hook del servizio. Per altre informazioni su altre app e servizi che si integrano con Azure DevOps, vedere Visual Studio Marketplace.
| Service | Eventi supportati | Azioni supportate |
|---|---|---|
| App Center | Elemento di lavoro aggiornato | Inviare una notifica. Le sottoscrizioni vengono gestite tramite App Center. |
| AppVeyor | Push del codice | Attivare una compilazione di AppVeyor. Le sottoscrizioni vengono gestite tramite AppVeyor. |
| Azuqua | Tutte le date | Pubblicare l'evento a FLO. Le sottoscrizioni vengono gestite tramite Azuqua. |
| Servizio app di Azure | Push del codice | Distribuire un'app Web. Le sottoscrizioni vengono gestite tramite app Azure Servizio. |
| Bus di servizio di Azure | Tutte le date | Inviare un messaggio a un hub di notifica, bus di servizio coda o bus di servizio argomento. La sottoscrizione viene gestita tramite app Azure Servizio. |
| Archiviazione di Azure | Tutte le date | Inserire un messaggio in una coda di archiviazione. |
| Bambù | Compilazione completata, push del codice | Accoda una compilazione. |
| Datadog | Tutte le date | Pubblicare un evento in Datadog. |
| Grafana | Distribuzione del rilascio completata | Aggiungere annotazione al database Grafana. |
| Jenkins | Compilazione completata, push del codice, tentativo di unione pull, distribuzione della versione completata | Attivare la compilazione generica o Git. |
| Microsoft Teams | Tutte le date | Pubblicare un messaggio in un canale. Le sottoscrizioni vengono gestite in Microsoft Teams. |
| MyGet | Compilazione completata, push del codice | Pubblicare il pacchetto NuGet in MyGet. Attivare una compilazione MyGet. Le sottoscrizioni vengono gestite da MyGet. |
| Office 365 | Tutte le date | Pubblicare un messaggio in un gruppo. |
| Slack | Tutte le date | Pubblicare un messaggio in un canale. |
| Trello | Tutte le date | Creare una scheda o un elenco. |
| UserVoice | Elemento di lavoro creato, elemento di lavoro aggiornato | Invia evento dell'elemento di lavoro collegato. Le sottoscrizioni vengono gestite tramite UserVoice. |
| Web Hook | Tutte le date | Pubblicare tramite HTTP. |
| App per i messaggi dell'area di lavoro | Tutte le date | Inviare notifiche. Le sottoscrizioni vengono gestite tramite Workplace Message Apps. |
| Zapier | Tutte le date | Inviare una notifica. Le sottoscrizioni vengono gestite tramite Zapier. |
| Zendesk | Commento dell'elemento di lavoro | Creare un commento privato in un ticket. |
| Service | Eventi supportati | Azioni supportate |
|---|---|---|
| Bus di servizio di Azure | Tutte le date | Inviare un messaggio a un hub di notifica, bus di servizio coda o bus di servizio argomento. La sottoscrizione viene gestita tramite app Azure Servizio. |
| Archiviazione di Azure | Tutte le date | Inserire un messaggio in una coda di archiviazione. |
| Bambù | Compilazione completata, push del codice | Accoda una compilazione. |
| Datadog | Tutte le date | Pubblicare un evento in Datadog. |
| Grafana | Distribuzione del rilascio completata | Aggiungere annotazione al database Grafana. |
| Jenkins | Compilazione completata, push del codice, tentativo di unione pull, distribuzione della versione completata | Attivare la compilazione generica o Git. |
| Microsoft Teams | Tutte le date | Pubblicare un messaggio in un canale. Le sottoscrizioni vengono gestite in Microsoft Teams. |
| Office 365 | Tutte le date | Pubblicare un messaggio in un gruppo. |
| Slack | Tutte le date | Pubblicare un messaggio in un canale. |
| Trello | Tutte le date | Creare una scheda o un elenco. |
| [UserVoice] ((https://www.uservoice.com) | Elemento di lavoro creato, elemento di lavoro aggiornato | Invia evento dell'elemento di lavoro collegato. Le sottoscrizioni vengono gestite tramite UserVoice. |
| Web Hook | Tutte le date | Pubblicare tramite HTTP. |
| Zendesk | Commento dell'elemento di lavoro | Creare un commento privato in un ticket. |
Creare una sottoscrizione
Integrando uno di questi servizi con Azure DevOps, è necessario creare una nuova sottoscrizione. In molti casi, è necessario eseguire anche alcune configurazioni nell'altro servizio. Per informazioni specifiche, vedere le informazioni relative al servizio a cui si è interessati.
Aprire la pagina di amministrazione per un progetto nell'accesso Web.
Eseguire la procedura guidata per creare la sottoscrizione.
Selezionare il servizio con cui si vuole eseguire l'integrazione.
Selezionare l'evento da attivare ed eventuali filtri applicabili.
Selezionare un'azione da eseguire nel servizio di destinazione.
Nota
L'elenco delle azioni disponibili può essere limitato in base al tipo di evento selezionato.
Per verificare che le impostazioni siano corrette, testare la sottoscrizione e quindi completare la procedura guidata.
Domande frequenti
D: Quali autorizzazioni è necessario configurare una sottoscrizione?
R: Modificare le sottoscrizioni e Visualizzare le sottoscrizioni. Per impostazione predefinita, solo gli amministratori del progetto dispongono di queste autorizzazioni. Per concederle direttamente ad altri utenti, è possibile usare lo strumento della riga di comando o l'API REST Sicurezza.
Per concedere l'autorizzazione Visualizzazione per un gruppo, vedere Impostare l'autorizzazione di visualizzazione per un gruppo nella pagina Service Hooks .To grant View permission for a group, see Set View permission for a group in Service Hooks page.
D: Quali sono le implicazioni per la sicurezza della concessione delle sottoscrizioni di modifica e delle autorizzazioni Di visualizzazione delle sottoscrizioni ?
R: L'utente con queste autorizzazioni può visualizzare tutte le sottoscrizioni create nel progetto e la cronologia delle notifiche per tali sottoscrizioni. Tale utente può quindi creare qualsiasi tipo di sottoscrizione hook del servizio in tale progetto. Se l'utente configura una sottoscrizione per una risorsa a cui non ha altrimenti l'autorizzazione per l'accesso, la sottoscrizione non verrà attivata.
Ad esempio: le sottoscrizioni create per gli eventi di aggiornamento degli elementi di lavoro nel percorso dell'area XYZ non invierà notifiche se non si ha accesso a tali elementi di lavoro. Tuttavia, è possibile visualizzare la cronologia delle notifiche di altri utenti che hanno accesso a tali elementi di lavoro.
D: È possibile creare sottoscrizioni hook del servizio per un progetto a livello di codice?
R: Sì. Per altre informazioni, vedere Creare una sottoscrizione hook del servizio.
D: È possibile rimuovere l'accesso di un'app all'organizzazione dopo averla autorizzata?
R: Sì. È possibile revocare le autorizzazioni dal profilo.
Passare alla pagina del profilo da https://visualstudio.microsoft.com/.
Assicurarsi di iniziare dal sito di Visual Studio () anziché dall'organizzazione (https://visualstudio.microsoft.com/
https://dev.azure.com/{orgName}) perché il profilo a cui si accede dall'organizzazione passa all'implementazione errata della funzionalità di gestione delle autorizzazioni.Gestire le autorizzazioni.
Revocare le autorizzazioni che non si desidera più consentire.
D: Perché non è più possibile configurare hook di servizio per HipChat?
R: Atlassian ha ufficialmente rilasciato il supporto per HipChat. Per altre informazioni, vedere l'annuncio.