Integrazione con i ganci 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 collegamenti di servizio nelle applicazioni e nei servizi personalizzati come modo più efficace per stimolare le attività quando avvengono eventi nei tuoi progetti.

Come funzionano gli hook del servizio?

Gli hook di servizio publisher definiscono un insieme di eventi a cui è possibile iscriversi. Le sottoscrizioni ascoltano questi eventi e definiscono azioni da intraprendere sulla base dell'evento.

Le sottoscrizioni sono rivolte anche ai consumatori, ossia servizi esterni che possono eseguire azioni proprie al verificarsi di 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 è l'insieme di proprietà fornite a un gancio 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. Le sottoscrizioni vengono gestite tramite App Center.
AppVeyor	Codice inviato	Attivare un build di AppVeyor. Le sottoscrizioni vengono gestite tramite AppVeyor.
Azuqua	Tutti	Pubblicare l'evento a FLO. Le sottoscrizioni vengono gestite tramite Azuqua.
Servizio app di Azure	Codice inviato	Distribuire un'app Web. Le sottoscrizioni vengono gestite tramite Servizio App di Azure.
Bus di servizio di Azure	Tutti	Inviare un messaggio a un Hub di Notifica, una coda di Service Bus o un argomento di Service Bus. La sottoscrizione è gestita tramite il servizio app di Azure.
Archiviazione di Azure	Tutto	Inserire un messaggio in una coda di archiviazione.
Bambù	Compilazione completata, codice caricato	Accoda una compilazione.
Datadog	Tutti	Pubblicare un evento in Datadog.
Grafana	Distribuzione completata	Aggiungere annotazione al database Grafana.
Jenkins	Compilazione completata, push del codice, tentativo di unione della pull request, distribuzione della versione completata	Attivare la compilazione generica o Git.
Microsoft Teams	Tutto	Pubblicare un messaggio in un canale. Le sottoscrizioni vengono gestite in Microsoft Teams.
MyGet	Compilazione completata, codice inviato	Pubblicare il pacchetto NuGet in MyGet. Attivare una compilazione MyGet. Le sottoscrizioni vengono gestite da MyGet.
Office 365	Tutto	Pubblicare un messaggio in un gruppo.
Slack	Tutto	Pubblicare un messaggio in un canale.
Trello	Tutto	Creare una scheda o un elenco.
UserVoice	Elemento di lavoro creato, elemento di lavoro aggiornato	Invia l'evento dell'elemento di lavoro collegato. Le sottoscrizioni vengono gestite tramite UserVoice.
Web Hooks	Tutto	Pubblicare tramite HTTP.
App per i messaggi dell'area di lavoro	Tutto	Inviare notifiche. Le sottoscrizioni vengono gestite tramite Workplace Message Apps.
Zapier	Tutti	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 tramite 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 sono necessarie per 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, vedi la pagina Impostare l'autorizzazione Visualizzazione per un gruppo in Service Hooks.

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 al collegamento 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 invieranno notifiche se non si dispone di 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 ulteriori informazioni, vedere Creare una sottoscrizione ai 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/.

   Assicurati di iniziare dal sito di Visual Studio (https://visualstudio.microsoft.com/) invece che dalla tua organizzazione (https://dev.azure.com/{orgName}) perché il profilo a cui si accede dalla tua organizzazione porta 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 i service hooks per HipChat?

Atlassian ha ufficialmente interrotto 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