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.