L'utilisateur Super API Penneo est un rôle utilisateur spécialisé avec des droits à la fois limités et étendus, conçu pour offrir un contrôle à l’échelle du compte pour les intégrations, notamment en ce qui concerne l'accès aux documents signés. Ce rôle est créé pour donner aux organisations un meilleur contrôle sur des aspects spécifiques d'une intégration Penneo.
Accès aux données à l’échelle du compte pour les utilisateurs Super API
Contrairement aux utilisateurs réguliers qui ne peuvent voir que les documents qu’ils ont créés ou qui leur ont été partagés, un utilisateur Super API dispose d’un accès aux données à l’échelle du compte.
- Visibilité complète : Il peut accéder à tous les dossiers et documents de l’ensemble de votre compte Penneo.
- Conçu pour les intégrations : Il offre une vue globale et complète de tous les documents de votre organisation, ce qui en fait la solution idéale pour des intégrations automatisées à l’échelle du système.
Limitations et restrictions du rôle Super API
Pour garantir la sécurité et l’intégrité du système, l’utilisateur Super API est soumis à un ensemble très spécifique de règles. Voici ce qu’il peut et ne peut pas faire :
| Ce qu’il PEUT faire : | Ce qu’il NE PEUT PAS faire : |
|---|---|
| Accès à l’échelle du compte : Voir et récupérer tous les dossiers et documents. | Pas d’accès à l’application web : Ne peut pas se connecter à l’interface web ou à l’archive Penneo. |
| Accès uniquement via API : Se connecter exclusivement via l’API Penneo. | Pas d’envoi : Ne peut pas créer ni envoyer de dossiers pour signature. |
| Rôle permanent : Une fois créé, il ne peut pas être converti en utilisateur régulier ou administrateur. |
Création d’un utilisateur Super API Penneo
Suivez ces étapes pour créer un utilisateur Super API dans la configuration de l’entreprise Penneo :
- Accédez à la vue d’ensemble des utilisateurs dans la configuration de l’entreprise.
- Cliquez sur 'Créer un nouvel utilisateur'.
- Indiquez un nom et une adresse e-mail pour l’utilisateur.
- Sélectionnez 'Utilisateur Super API' pour le rôle. Notez que les clés API sont automatiquement imposées comme unique méthode de connexion disponible.
- Cliquez sur 'Créer l’utilisateur'. Notez qu’aucun e-mail d’invitation n’est envoyé pour ce rôle utilisateur.
- Copiez immédiatement la clé API et le secret, car ils ne seront plus affichés par la suite.
Il est crucial de copier les identifiants lors de la dernière étape du processus de création. Vous ne recevrez pas d’e-mail d’invitation contenant ces identifiants, et ils ne peuvent pas être récupérés une fois la fenêtre fermée.
Réinitialisation des identifiants API Penneo
Si les clés API sont perdues ou doivent être remplacées, les administrateurs peuvent réinitialiser les identifiants d’un utilisateur Super API Penneo. Sachez que toute intégration utilisant les anciennes clés cessera de fonctionner immédiatement après la réinitialisation des identifiants.
- Accédez à la vue d’ensemble des utilisateurs et trouvez l’utilisateur Super API dans la liste des utilisateurs.
- Sélectionnez l’option pour modifier l’utilisateur.
- Choisissez de réinitialiser les identifiants.
- De nouvelles clés API seront générées et affichées une seule fois. Vous devez copier et enregistrer ces clés immédiatement, car elles ne seront plus accessibles une fois la fenêtre fermée.
Suppression d’un utilisateur Super API
Les administrateurs Penneo peuvent supprimer un utilisateur Super API de la même manière que pour les autres types d’utilisateurs. Des instructions détaillées pour ce processus sont disponibles dans ce guide : Administration des utilisateurs dans Penneo
La suppression de l’utilisateur désactive immédiatement la clé API et le secret associés. Toute intégration reposant sur ces identifiants cessera de fonctionner immédiatement.