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.

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.

   

2. Eseguire la procedura guidata per creare la sottoscrizione.

   

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

   

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

   

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.

   

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

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.

   

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

Articoli correlati

• Risolvere i problemi relativi agli hook del servizio e alle domande frequenti
• Visual Studio Marketplace
• Informazioni di fatturazione