> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 1Password

> Supervisez les tentatives de connexion, les événements d’audit et l’utilisation des éléments dans votre compte 1Password

L’intégration 1Password vous permet d’ingérer les événements pertinents pour la sécurité de votre compte 1Password, notamment :

* **Tentatives de connexion** : suivez les tentatives d’authentification réussies et échouées
* **Événements d’audit** : supervisez les actions d’administration et les modifications de configuration
* **Utilisation des éléments** : voyez quand des identifiants et des secrets sont consultés

## Prérequis

Avant de configurer cette intégration, assurez-vous de disposer :

1. D’un compte 1Password Business ou 1Password Teams
2. De privilèges de propriétaire ou d’administrateur dans votre compte 1Password
3. D’un accès à la 1Password Admin Console

## Étape 1 : créer une intégration Events Reporting

1. Connectez-vous à votre [1Password Admin Console](https://start.1password.com/)
2. Accédez à **Integrations** dans la barre latérale
3. Cliquez sur **Directory** en haut de la page
4. Recherchez **Events Reporting**, puis sélectionnez Other
5. Cliquez sur **Add Integration**
6. Donnez à votre intégration un nom descriptif (par exemple « Wirespeed Events Integration »)
7. Cliquez sur **Save**

## Étape 2 : générer un jeton Bearer

Après avoir créé l’intégration :

1. Une section **Set up token** s’affiche
2. Cliquez sur **Generate token** (ou **Regenerate token** si un jeton existe déjà)
3. Sous **Events to Report**, sélectionnez les trois types d’événements :
   * Sign-in attempts
   * Item usages
   * Audit events
4. **Important** : copiez le jeton et conservez-le immédiatement en lieu sûr. Vous ne pourrez plus l’afficher par la suite.
5. Le jeton ressemble à ceci : `eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`

> [!WARNING]
>
> Conservez votre jeton Bearer en lieu sûr. Si vous le perdez, vous devrez en générer un nouveau, ce qui invalidera l’ancien jeton.

> [!NOTE]
>
> Chaque type d’événement correspond à une fonctionnalité distincte du jeton. Si vous en omettez une, Wirespeed se connecte quand même et collecte les types sélectionnés. La fonctionnalité manquante apparaît sous forme d’avertissement de droit sur la page de l’intégration, et non comme une erreur répétée.

## Étape 3 : identifier l’URL de votre serveur

1Password utilise différentes URL de serveur selon le type de compte et la région. Utilisez l’URL appropriée :

| Type de compte | URL du serveur |
| - | - |
| 1Password Business (États-Unis) | `https://events.1password.com` |
| 1Password Business (Canada) | `https://events.1password.ca` |
| 1Password Business (UE) | `https://events.1password.eu` |
| 1Password Enterprise | `https://events.ent.1password.com` |

> [!TIP]
>
> Si vous ne savez pas quel serveur utiliser, vérifiez votre URL de connexion 1Password. Si vous vous connectez sur `my.1password.ca`, utilisez le serveur canadien (`events.1password.ca`).

## Étape 4 : ajouter l’intégration dans Wirespeed

1. Connectez-vous à Wirespeed et accédez à Intégrations > [**Ajouter une intégration**](https://app.wirespeed.co/settings/integrations?tab=browse)
2. Recherchez et sélectionnez **1Password Events API**
3. Saisissez les informations suivantes :
   * **URL du serveur** : l’URL de serveur appropriée identifiée à l’étape 3
   * **Jeton API** : le jeton Bearer généré à l’étape 2
4. Cliquez sur **Intégrer** pour terminer la configuration

## Quels événements sont collectés ?

### Tentatives de connexion

Ces événements suivent les tentatives d’authentification à votre compte 1Password, notamment :

* Les connexions réussies
* Les tentatives d’authentification échouées
* Les vérifications MFA
* Les tentatives de connexion bloquées par une politique

### Événements d’audit

Événements d’administration et de configuration, notamment :

* La gestion des utilisateurs (invitations, suppressions, changements de rôle)
* La création de coffres et les modifications d’autorisations
* La gestion des groupes
* Les modifications de politiques
* La configuration des intégrations

### Utilisation des éléments

Événements indiquant quand des secrets sont consultés :

* Affichage d’identifiants
* Copie de mots de passe
* Utilisation du remplissage automatique
* Export d’éléments

## Dépannage

### Erreurs d’authentification

Si vous rencontrez des erreurs d’authentification :

1. Vérifiez que votre jeton Bearer est correct et n’a pas expiré
2. Assurez-vous d’utiliser l’URL de serveur correspondant à votre type de compte
3. Vérifiez que votre intégration est toujours active dans la 1Password Admin Console

### Types d’événements manquants

Si l’intégration affiche un avertissement indiquant qu’une fonctionnalité du jeton est manquante (sign-in attempts, item usages ou audit events) :

1. Ouvrez la 1Password Admin Console et modifiez l’intégration Events Reporting
2. Générez un **nouveau** jeton en sélectionnant le type d’événement manquant sous **Events to Report**
3. Mettez à jour le jeton API dans Wirespeed

Le jeton précédent ne peut pas être étendu à d’autres types d’événements. Sa régénération le remplace.

### Aucun événement n’apparaît

Si les événements ne s’affichent pas :

1. Les événements peuvent mettre quelques minutes à apparaître après la configuration initiale
2. Vérifiez qu’une activité a bien lieu dans votre compte 1Password
3. Vérifiez que la fonctionnalité Events Reporting est activée sur votre compte 1Password

### Limitation du débit

L’API 1Password Events applique des limites de débit. Si vous atteignez ces limites :

1. Wirespeed réessaie automatiquement avec un délai exponentiel
2. Les événements seront collectés lors du cycle de synchronisation suivant

## Ressources complémentaires

* [Documentation de l’API 1Password Events](https://developer.1password.com/docs/events-api/)
* [Référence de l’API 1Password Events](https://developer.1password.com/docs/events-api/reference/)
* [Configurer Events Reporting](https://developer.1password.com/docs/events-api/get-started/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.