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 OAuth 2.0 pour une authentification sécurisée.

**Important**  
** AWS DevOps L'agent prend uniquement en charge la nouvelle version PagerDuty OAuth 2.0 (Scoped OAuth). L'ancienne version PagerDuty OAuth 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 client OAuth 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 choisissez **Enregistrer**

1. Suivez la configuration guidée 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 d'**OAuth 2.0 Scoped OAuth**
+ Sous **Autorisations**, accordez les étendues minimales requises suivantes :`incidents.read`,`incidents.write`, `services.read``webhook_subscriptions.read`, et `webhook_subscriptions.write`
+ Activez **l'intégration des événements** pour permettre une communication bidirectionnelle entre AWS DevOps l'agent et PagerDuty

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

### É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. Choisissez **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**, choisissez **Ajouter**

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

1. Choisissez **Enregistrer**.

## Gestion des PagerDuty connexions
<a name="managing-pagerduty-connections"></a>
+ **Mise à jour des informations d'identification** — Si vos informations d'identification OAuth 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, puis choisissez **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.