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

# Gérer et dépanner une intégration

> Contrôler une connexion, ses actions et ses droits sans déconnecter trop tôt.

> [!NOTE]
>
> Référence · 8 min

Une intégration dépend de trois couches : l’autorisation enregistrée dans Alyzai, les droits du
compte chez le fournisseur et l’accès de ce compte à la ressource demandée. Identifiez la couche en
échec avant de reconnecter ou de supprimer quoi que ce soit.

## États et options à distinguer

| Signal ou action | Ce qu’il prouve ou permet | Ce qu’il ne prouve pas |
| - | - | - |
| **Connecter** | aucun compte actif n’est associé pour votre contexte | que le connecteur est indisponible dans le workspace |
| **Connecté** | une autorisation active est enregistrée | que toutes les ressources sont visibles |
| **Configurer** | ouvre la fiche de l’intégration | qu’un mappage ou une fréquence globale existe |
| **Voir les actions** | liste les opérations exposées et leurs paramètres | que le compte possède les droits pour chaque opération |
| **Déconnecter** | retire l’autorisation associée | que les workflows dépendants seront réparés automatiquement |
| **Action indisponible** | le connecteur ne l’expose pas dans sa version actuelle | que le même usage est impossible avec un autre connecteur |

## Contrôles rapides

| Symptôme | Vérification |
| - | - |
| Le service demande de s’authentifier | reconnectez avec l’identité attendue et relisez les autorisations |
| Une ressource n’apparaît pas | vérifiez son partage et le rôle du compte dans le service externe |
| Une action attendue manque | ouvrez **Configurer › Voir les actions** et confirmez le connecteur choisi |
| Une action d’écriture est refusée | le compte peut disposer de la lecture sans l’envoi, la création ou la mutation |
| Cela fonctionne pour un collègue | comparez les identités connectées et les droits personnels chez le fournisseur |
| Un workflow échoue après reconnexion | vérifiez le compte, les paramètres de l’action et la ressource ciblée |

## Diagnostiquer sans perdre la connexion

**1. Notez le contexte exact**

Relevez le connecteur, l’action, le compte anonymisé, la date, le message d’erreur et la
ressource test. Identifiez aussi les agents, automatisations ou collections qui utilisent
cette connexion.

**2. Ouvrez la fiche Configurer**

Dans **Paramètres › Comptes connectés**, recherchez le service puis cliquez sur
**Configurer**. Vérifiez l’état et ouvrez **Voir les actions** pour confirmer que
l’opération attendue est réellement proposée.

**3. Vérifiez le service externe**

Confirmez que le compte est actif, que la ressource reste partagée avec lui et que son rôle
autorise l’opération. Une permission retirée chez le fournisseur ne peut pas être réparée
depuis Alyzai.

**4. Rejouez une lecture contrôlée**

Utilisez une ressource connue et une action sans effet externe. Si la lecture réussit,
testez ensuite l’écriture séparément avec une validation humaine.

**5. Reconnectez seulement si nécessaire**

Une reconnexion peut changer l’identité et les autorisations. Vérifiez le compte proposé
avant de confirmer, puis rejouez les scénarios dépendants.

> [!WARNING]
>
> **Déconnecter** retire l’autorisation. Des agents, workflows ou sources peuvent la réutiliser.
> Recensez ces dépendances et privilégiez une reconnexion avant toute suppression.

## Permissions et sécurité

* N’envoyez jamais de mot de passe, code temporaire, cookie ou jeton OAuth au support.
* Accordez uniquement les autorisations nécessaires aux actions utilisées.
* Contrôlez séparément les droits de lecture, d’envoi, de création, de modification et de
  suppression.
* Retirez les connexions personnelles d’un compte qui quitte l’organisation.
* Utilisez un propriétaire durable pour les usages partagés lorsque la politique de votre
  organisation le permet.
* Après un changement d’identité, vérifiez les ressources visibles avant de relancer un traitement.

## Questions fréquentes

> [accordion] Pourquoi Connecté ne suffit-il pas ?
>
> Le badge confirme l’autorisation générale. Le fichier, dossier ou compte délégué peut rester
> hors du partage ou être limité à la lecture.

> [accordion] Où voir ce que le connecteur sait faire ?
>
> Ouvrez Paramètres, Comptes connectés, Configurer, puis Voir les actions. La liste détaille
> les opérations et le nombre de paramètres attendus.

> [accordion] Faut-il déconnecter puis reconnecter ?
>
> Non en première intention. Vérifiez d’abord l’action, le compte et la ressource. Déconnecter
> peut interrompre les dépendances existantes.

> [accordion] Que fournir au support ?
>
> Le connecteur, l’action, le compte anonymisé, la date, la ressource test, le message exact
> et les dépendances affectées, sans aucun secret.

<Snippet file="snippets/support.mdx" />

## Étapes suivantes

> [card] [Connecter une intégration](https://docs.alyzai.com/fr/integrations/connecter-un-connecteur.md)
>
> Revoir le parcours d’autorisation et de vérification.

> [card] [Gérer les comptes connectés](https://docs.alyzai.com/fr/mon-compte/comptes-connectes.md)
>
> Vérifier les connexions liées à votre identité.


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