# Identifiants et clés API | Docs - nodulz

Source: https://nodulz.com/fr/docs/credentials

Language: fr

Un identifiant regroupe les accès réutilisés par les nœuds : clé API, token, compte de service, connexion de base de données ou clé SSH. Préparez d’abord l’opération et la ressource visées : elles déterminent les permissions à accorder.

## Choisir le bon type

Ouvrez la fiche du nœud et suivez sa section **Identifiants et prérequis**. Le type doit correspondre à celui attendu par le connecteur, pas seulement au nom du service.

- **Envoyer ou recevoir un e-mail** : SMTP sert à l’envoi ; IMAP sert à la réception.
- **Appeler Stripe ou recevoir ses événements** : une clé d’API et un secret de signature webhook ont des usages différents.
- **Interroger PostgreSQL ou un index vectoriel** : les connexions PostgreSQL et pgvector sont proposées pour des nœuds distincts.
- **Utiliser un modèle IA** : vérifiez le fournisseur de l’identifiant et l’accès au modèle choisi par le nœud.

Les procédures de la rubrique **Clés et connexions** indiquent les champs à renseigner. Elles renvoient aux références officielles pour les étapes propres au fournisseur.

## Créer et utiliser un identifiant

1. Dans votre instance nodulz, ouvrez **Identifiants** et choisissez le type attendu.
2. Donnez un nom qui distingue le service, l’usage et l’environnement, par exemple `CRM - lecture - test`. Ne mettez pas de secret dans le nom.
3. Renseignez les champs du formulaire. Vérifiez l’hôte ou l’URL, le compte, la région, le port et TLS lorsque ces réglages existent.
4. Choisissez le partage nécessaire, puis enregistrez. Un identifiant partagé ne donne pas automatiquement le droit de le modifier.
5. Sélectionnez cet identifiant dans le nœud et lancez le test de connexion s’il est proposé.
6. Testez ensuite l’opération exacte sur une ressource de test. Une connexion réussie ne prouve pas le droit de créer, modifier ou supprimer cette ressource.

Séparez les accès de test et de production. Accordez les permissions nécessaires à l’opération, et utilisez un compte technique lorsque le fournisseur le permet.

## Si l’identifiant n’apparaît pas

Vérifiez son type, son propriétaire et son partage. Le propriétaire du workflow doit pouvoir utiliser l’accès : pouvoir ouvrir ou modifier un workflow ne suffit pas pour déduire les droits sur chaque identifiant.

Si plusieurs accès portent des noms proches, choisissez celui du bon environnement. Modifier un identifiant réutilisé peut affecter plusieurs workflows ; repérez ses usages avant de le changer.

## Connexion et autorisation

Utilisez le message du service pour choisir le contrôle suivant :

- **Authentification refusée** : vérifiez le secret, son expiration, sa révocation et le type d’authentification attendu. Un statut 401 peut orienter vers cette cause.
- **Opération interdite** : vérifiez les permissions, le compte, le projet et le partage de la ressource. Un statut 403 peut orienter vers cette cause.
- **Ressource introuvable** : vérifiez aussi l’environnement, la région et l’identifiant de ressource ; recréer une clé ne corrige pas une mauvaise cible.
- **Connexion impossible** : vérifiez réseau, DNS, hôte, port et TLS depuis l’environnement qui exécute nodulz, pas seulement depuis votre navigateur.

Les codes et messages précis dépendent du fournisseur. Consultez sa procédure et le [dépannage](/docs/troubleshooting) avant de modifier plusieurs réglages à la fois.

## Rotation

1. Repérez les workflows et environnements qui utilisent l’accès actuel.
2. Créez le nouvel accès chez le fournisseur avec les permissions nécessaires.
3. Mettez à jour l’identifiant nodulz, ou créez un identifiant distinct si vous devez migrer les workflows progressivement.
4. Vérifiez une opération représentative pour chaque usage, y compris un déclenchement réel si l’accès sert à un déclencheur.
5. Révoquez l’ancien accès chez le fournisseur une fois les vérifications terminées.

> [!WARNING] En cas de secret compromis
>
> Révoquez le secret compromis sans attendre une rotation ordinaire. Remplacez-le, vérifiez les usages affectés et examinez l’activité associée chez le fournisseur.

## Partager un exemple ou des logs

Gardez les secrets hors des champs de texte ordinaires lorsque le nœud propose un identifiant dédié. Ne copiez pas les clés dans les prompts, exemples partagés, captures ou logs. Vérifiez aussi les en-têtes et les URLs qui peuvent contenir un token avant de transmettre une trace au support.

## Pour aller plus loin

- [Fonctionnalités - nodulz](https://nodulz.com/fr/product/overview)
- [Catalogue des nœuds - nodulz](https://nodulz.com/fr/product/catalog)
- [Serveur MCP - nodulz](https://nodulz.com/fr/product/mcp)
- [Tarifs - nodulz](https://nodulz.com/fr/pricing)
- [Cas d’usage et automatisations - nodulz](https://nodulz.com/fr/use-cases)
- [Choisissez ce que vos workflows peuvent faire. - nodulz](https://nodulz.com/fr/compare)
- [Documentation - nodulz](https://nodulz.com/fr/docs)