Mailgun

{{< details >}}

• Édition : Gratuite, GitLab Premium, GitLab Ultimate
• Offre : GitLab Self-Managed

{{< /details >}}

Lorsque vous utilisez Mailgun pour envoyer des e-mails pour votre instance GitLab et que l'intégration Mailgun est activée et configurée dans GitLab, vous pouvez recevoir leur webhook pour le suivi des échecs de livraison. Pour configurer l'intégration, vous devez :

1. Configurer votre domaine Mailgun.
2. Activer l'intégration Mailgun.

Une fois l'intégration terminée, les webhooks Mailgun temporary_failure et permanent_failure sont envoyés à votre instance GitLab.

Configurer votre domaine Mailgun {#configure-your-mailgun-domain}

{{< history >}}

• Obsolète : l'URL /-/members/mailgun/permanent_failures dans GitLab 15.0.
• Modification de l'URL pour gérer les échecs temporaires et permanents dans GitLab 15.0.

{{< /history >}}

Avant de pouvoir activer Mailgun dans GitLab, configurez vos propres endpoints Mailgun pour recevoir les webhooks.

En utilisant le guide des webhooks Mailgun :

1. Ajoutez un webhook avec le Type d'événement défini sur Échec permanent.

2. Saisissez l'URL de votre instance et incluez le chemin /-/mailgun/webhooks.

   Par exemple :

   plaintextCopy

   https://myinstance.gitlab.com/-/mailgun/webhooks
   

3. Ajoutez un autre webhook avec le Type d'événement défini sur Temporary Failure.

4. Saisissez l'URL de votre instance et utilisez le même chemin /-/mailgun/webhooks.

Activer l'intégration Mailgun {#enable-mailgun-integration}

Après avoir configuré votre domaine Mailgun pour les endpoints de webhook, vous êtes prêt à activer l'intégration Mailgun :

1. Connectez-vous à GitLab en tant qu'utilisateur Administrateur.
2. Dans le coin supérieur droit, sélectionnez Admin.
3. Dans la barre latérale gauche, accédez à Paramètres > Général et développez la section Mailgun.
4. Cochez la case Activer Mailgun.
5. Saisissez la clé de signature du webhook HTTP Mailgun comme décrit dans la documentation Mailgun et indiqué dans la section Sécurité API (https://app.mailgun.com/app/account/security/api_keys) de votre compte Mailgun.
6. Sélectionnez Sauvegarder les modifications.