Cet article traite des différentes APIs de Cato qui vous permettent de gérer les administrateurs et les rôles d'administrateur pour l'application de gestion Cato. Cette API prend en charge la gestion des administrateurs pour les comptes de revendeur et les comptes réguliers.
L’API de configuration addAdmin crée de nouveaux administrateurs pour le compte dans l'application de gestion Cato.
Voici les arguments pour l’API de configuration addAdmin :
- firstName : Le prénom de l'admin (max 255 caractères) - ce champ est obligatoire
- lastName : Le nom de famille de l'admin (max 255 caractères) - ce champ est obligatoire
- email : L'adresse e-mail, unique par admin (max 255 caractères) - ce champ est obligatoire
- passwordNeverExpires : Valeur booléenne (vrai/faux). Si la valeur est définie à vrai, le mot de passe de l'administrateur n'expire jamais - ce champ est obligatoire
- mfaEnabled : Valeur booléenne (vrai/faux). Si la valeur est définie sur vrai, l'administrateur doit utiliser un code MFA pour se connecter à l'Application de gestion Cato - ce champ est obligatoire
-
managedRoles : tableau de updateAdminRoleInput. Définit un ou plusieurs rôles qui sont assignés à l'administrateur. Pour les administrateurs revendeurs, ce champ définit les rôles qui sont assignés à l'administrateur pour les comptes gérés. Si ce champ n'est pas défini pour l'appel API, l'administrateur se voit attribuer le rôle de visualiseur (ID 2)
- Utilisez l'ID 1 pour assigner le rôle d'éditeur à l'admin
- rôlesReseller : tableau de updateAdminRoleInput (relevant uniquement pour les administrateurs revendeurs). Définit les rôles que l'admin est assigné pour le compte revendeur. Si ce champ n'est pas défini pour l'appel API, alors l'admin est attribué le rôle de visualiseur pour le compte revendeur.
Une fois l'admin créé, le déroulement est le même que s'il avait été créé dans l'Application de gestion Cato.
Si le compte est défini pour permettre aux administrateurs de se connecter avec un nom d'utilisateur et un mot de passe, l'administrateur recevra l'e-mail de bienvenue avec un lien pour activer le compte et définir le mot de passe.
L'API de configuration updateAdmin vous permet de mettre à jour les informations de l'administrateur (l'e-mail et l'ID de l'administrateur ne peuvent pas être mis à jour).
- adminID (obligatoire)
- firstName : Le prénom de l'admin
- lastName : Le nom de l'admin
- passwordNeverExpires : Valeur booléenne (vrai/faux). Si la valeur est définie à vrai, le mot de passe de l'administrateur n'expire jamais
- mfaEnabled : Valeur booléenne (vrai/faux). Si la valeur est définie à vrai, l'administrateur doit utiliser un code MFA pour se connecter à l'Application de gestion Cato
- managedRoles : tableau de
updateAdminRoleInput. Définit un ou plusieurs rôles attribués à l'admin. Pour les administrateurs revendeurs, ce champ définit les rôles assignés à l'admin pour les comptes gérés. - rôlesReseller : tableau de
updateAdminRoleInput(relevant uniquement pour les administrateurs revendeurs). Définit les rôles que l'admin est assigné pour le compte revendeur.
La requête de l'API admins en lecture seule renvoie des données concernant tous les administrateurs du compte, y compris : id, email, prénom, nom, passwordNeverExpires, mfaEnabled et Rôles.
- id : L'ID Cato de l'admin
- firstName : Le prénom de l'admin
- lastName : Le nom de l'admin
- email : L'adresse e-mail
- passwordNeverExpires : Valeur booléenne (vrai/faux). Si la valeur est définie à vrai, le mot de passe de l'administrateur n'expire jamais
- mfaEnabled : Valeur booléenne (vrai/faux). Si la valeur est définie à vrai, l'administrateur doit utiliser un code MFA pour se connecter à l'Application de gestion Cato
- managedRoles : tableau de updateAdminRoleInput. Définit un ou plusieurs rôles attribués à l'admin. Pour les administrateurs revendeurs, ce champ définit les rôles assignés à l'admin pour les comptes gérés.
- rôlesReseller : tableau de updateAdminRoleInput (relevant uniquement pour les administrateurs revendeurs). Définit les rôles que l'admin est assigné pour le compte revendeur.
La requête de l'API getAdmin en lecture seule renvoie des informations sur un administrateur de compte unique, telles que : e-mail, prénom, nom, passwordNeverExpires, mfaEnabled et Rôles
- firstName : Le prénom de l'admin
- lastName : Le nom de l'admin
- email : L'adresse e-mail
- passwordNeverExpires : Valeur booléenne (vrai/faux). Si défini à vrai, le mot de passe de l'administrateur n'expire jamais
- mfaEnabled : Valeur booléenne (vrai/faux). Si défini à vrai, l'administrateur doit utiliser un code MFA pour se connecter à l'Application de gestion Cato
- managedRoles : tableau de updateAdminRoleInput. Définit un ou plusieurs rôles attribués à l'admin. Pour les administrateurs revendeurs, ce champ définit les rôles assignés à l'admin pour les comptes gérés.
- rôlesReseller : tableau de updateAdminRoleInput (relevant uniquement pour les administrateurs revendeurs). Définit les rôles que l'admin est assigné pour le compte revendeur.
La requête en lecture seule de l'API accountRoles renvoie tous les rôles définis pour le compte (rôles personnalisés et prédéfinis). Il est requis pour les clients qui utilisent l’API addAdmin car cette API montre les IDs de rôle (utilisés par l’API addAdmin).
- idCompte
-
Type de compte
- Régulier (pour les rôles de comptes réguliers ou gérés)
- Revendeur (pour les rôles de comptes de revendeur)
0 commentaire
Cet article n'accepte pas de commentaires.