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.

Diagramma degli hook del servizio.

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.

  1. Aprire la pagina di amministrazione per un progetto nell'accesso Web.

    Screenshot del pulsante Impostazioni progetto evidenziato.
  2. Eseguire la procedura guidata per creare la sottoscrizione.

    Screenshot del pulsante evidenziato, Crea sottoscrizione.

  3. Selezionare il servizio con cui si vuole eseguire l'integrazione.

    Selezionare il servizio da integrare

  4. Selezionare l'evento da attivare ed eventuali filtri applicabili.

    Selezionare l'evento da attivare e i filtri

  5. 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.

    Screenshot che mostra la selezione di un'azione per il servizio di destinazione.

  6. Per verificare che le impostazioni siano corrette, testare la sottoscrizione e quindi completare la procedura guidata.

    Screenshot che mostra la notifica di test 1.

    Screenshot che mostra la notifica di test 2.

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.

  1. 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.

  2. Gestire le autorizzazioni.

    Screenshot che mostra il pulsante Gestisci applicazioni evidenziato.

  3. Revocare le autorizzazioni che non si desidera più consentire.

    Screenshot che mostra l'opzione Revoca per le autorizzazioni.

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.