Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Connecter PagerDuty
<a name="connecting-to-ticketing-and-chat-connecting-pagerduty"></a>

PagerDuty l'intégration permet à l' AWS DevOps agent d'accéder aux données sur les incidents, aux horaires d'appel et aux informations de service à partir de votre PagerDuty compte et de les mettre à jour lors des enquêtes sur les incidents et des réponses automatisées. Cette intégration utilise la OAuth version 2.0 pour une authentification sécurisée.

**Important**  
** AWS DevOps L'agent ne prend en charge que la version PagerDuty OAuth 2.0 la plus récente (Scoped OAuth). L'ancienne PagerDuty OAuth version avec URI de redirection n'est pas prise en charge.

## PagerDuty exigences
<a name="pagerduty-requirements"></a>

Avant de vous connecter PagerDuty, assurez-vous d'avoir :
+ Un PagerDuty compte avec votre identifiant OAuth client et votre secret client
+ Le sous-domaine de votre PagerDuty compte (par exemple, si votre PagerDuty URL est`https://your-company.pagerduty.com`, le sous-domaine est) `your-company`

## S'inscrire PagerDuty
<a name="registering-pagerduty"></a>

PagerDuty est enregistré au niveau du AWS compte et partagé entre tous les espaces d'agent de ce compte.

### Étape 1 : configurer l'accès dans PagerDuty
<a name="step-1-configure-access-in-pagerduty"></a>

1. Connectez-vous à la console AWS de gestion

1. Accédez à la console de AWS DevOps l'agent

1. Accédez à la page **Capability Providers** (accessible depuis la navigation latérale)

1. Recherchez **PagerDuty**dans la section Fournisseurs **disponibles** sous **Communication** et cliquez sur **Enregistrer**

1. Suivez les instructions de configuration sur la PagerDuty page **Configurer l'accès dans** :

**Vérifiez votre région de service et votre sous-domaine :**
+ **Étendue du compte** — Sélectionnez votre PagerDuty région (**États-Unis** ou **UE**) et entrez votre PagerDuty sous-domaine. Par exemple, si votre PagerDuty URL est`https://your-company.pagerduty.com`, entrez`your-company`.

**Créez une nouvelle application dans PagerDuty :**
+ Dans un onglet de navigateur distinct, connectez-vous PagerDuty et accédez à **Intégrations > Enregistrement des applications**
+ Créez une nouvelle application à l'aide de **OAuth 2.0 Scoped OAuth**
+ Sous **Autorisations**, accordez les étendues minimales requises suivantes : `incidents.read``incidents.write`, et `services.read`
+ Activez **l'intégration des événements** pour permettre une communication bidirectionnelle entre AWS DevOps l'agent et PagerDuty

**Configurer les OAuth informations d'identification :**
+ **Étendue des autorisations** — Les étendues minimales requises sont les suivantes :`incidents.read`,, `incidents.write` `services.read`
+ **Nom du client** — Entrez un nom descriptif pour votre OAuth client
+ **ID client** — Entrez l'identifiant OAuth client indiqué lors de PagerDuty l'enregistrement de votre application
+ **Secret client** — Entrez le secret OAuth client indiqué lors de PagerDuty l'enregistrement de votre application

### Étape 2 : Vérifiez et soumettez PagerDuty l'enregistrement
<a name="step-2-review-and-submit-pagerduty-registration"></a>

1. Passez en revue tous les détails PagerDuty de configuration

1. Cliquez sur **Soumettre** pour terminer l'enregistrement

1. Une fois l'enregistrement réussi, PagerDuty apparaît dans la section **Actuellement enregistré** de la page Fournisseurs de capacités

## Ajouter PagerDuty à un espace d'agent
<a name="adding-pagerduty-to-an-agent-space"></a>

Une fois enregistré PagerDuty au niveau du compte, vous pouvez le connecter à des espaces d'agent individuels :

1. Dans la console AWS DevOps Agent, sélectionnez votre espace agent

1. Accédez à l'onglet **Fonctionnalités**

1. Dans la section **Communications**, cliquez sur **Ajouter**

1. Sélectionnez **PagerDuty**dans la liste des fournisseurs disponibles

1. Cliquez sur **Enregistrer**

## Gestion des PagerDuty connexions
<a name="managing-pagerduty-connections"></a>
+ **Mise à jour des informations d'identification** — Si vos OAuth informations d'identification doivent être mises à jour, désenregistrez-vous PagerDuty de la page des fournisseurs de capacités et enregistrez-vous à nouveau avec les nouvelles informations d'identification.
+ **Affichage des connexions** : dans la console de l' AWS DevOps agent, sélectionnez votre espace agent et accédez à l'onglet Fonctionnalités pour afficher les intégrations de communication connectées.
+ **Suppression PagerDuty** : pour vous PagerDuty déconnecter d'un espace agent, sélectionnez-le dans la section Communications et cliquez sur **Supprimer**. Pour supprimer complètement l'enregistrement, supprimez-le d'abord de tous les agents Spaces, puis désenregistrez-vous de la page Capability Providers.

## Support du webhook
<a name="webhook-support"></a>

AWS DevOps L'agent prend uniquement en charge les PagerDuty webhooks V3. Les versions antérieures du webhook ne sont pas prises en charge.

Pour plus d'informations sur les abonnements aux webhooks PagerDuty V3, consultez la section [Présentation des webhooks](https://developer.pagerduty.com/docs/webhooks-overview#webhook-subscriptions) dans la PagerDuty documentation destinée aux développeurs.