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.

Servizio	Eventi supportati	Azioni supportate
App Center	Elemento di lavoro aggiornato	Inviare una notifica
AppVeyor	Push del codice	Attivare una compilazione di AppVeyor
Azuqua	Tutte le date	Post-evento a FLO
Servizio app di Azure	Push del codice	Distribuire un'app Web
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
Archiviazione di Azure	Tutte le date	Inserire un messaggio in una coda Archiviazione
Bambù	Compilazione completata, push del codice	Accodamento di una compilazione
Campfire	Tutte le date	Pubblicare un messaggio in una sala
Datadog	Tutte le date	Pubblicare un evento in Datadog
Grafana	Distribuzione del rilascio completata	Aggiungere annotazione al database Grafana
HipChat	(Non più supportato)
HockeyApp	Elemento di lavoro aggiornato	Inviare una notifica
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
MyGet	Compilazione completata, push del codice	Pubblicare un pacchetto NuGet in MyGet, attivare una compilazione 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 o aggiornato	Invia evento dell'elemento di lavoro collegato
Web Hook	Tutte le date	Pubblicare tramite HTTP
App per i messaggi dell'area di lavoro	Tutte le date	Inviare notifiche
Zapier	Tutte le date	Inviare una notifica
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 alcune operazioni anche nell'altro servizio. Per informazioni specifiche, vedere le informazioni sul 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.

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 che non ha altrimenti l'autorizzazione per l'accesso, la sottoscrizione non verrà attivata.

Ad esempio: se non si ha accesso agli elementi di lavoro nel percorso dell'area XYZ e si configura una sottoscrizione per gli eventi di aggiornamento dell'elemento di lavoro, non si ricevono notifiche per gli aggiornamenti agli elementi di lavoro nel percorso area XYZ. Tuttavia, se un altro utente, che ha accesso agli elementi di lavoro nel percorso dell'area XYZ, riceve gli eventi di "aggiornamento degli elementi di lavoro", è possibile visualizzare la cronologia delle notifiche degli altri eventi dell'utente, che include i dati degli elementi di lavoro a cui non si ha altrimenti accesso.

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 su questo annuncio , vedere qui.

Articoli correlati

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