Les comptes de service sont des comptes utilisateurs spécialisés, conçus pour les intégrations système, les automatisations et les interactions non humaines. Ces comptes disposent généralement d'autorisations spécifiques pour effectuer des tâches telles que la création d'événements, la synchronisation de données ou la communication avec les applications. Ce guide explique comment créer et configurer un compte de service, garantissant ainsi une intégration sécurisée et efficace avec EarthRanger.

Étape 1 : Créer un ensemble d’autorisations approprié

Pour garantir que le compte de service dispose du niveau d’accès approprié, vous devrez peut-être créer un ensemble d’autorisations dédié.

1. Access the Permission Sets Page
   1. Log in to the Earthranger Admin page.
   2. Navigate to User Accounts > Permission Sets.
2. Check for an Existing Permission Set
   1. Search for a permission set that fits the needs of the integration or application.
   2. If a suitable permission set exists, proceed to the next step.
3. Add a New Permission Set (If Necessary)
   1. Click Add Permission Set in the top-right corner.
   2. Enter a descriptive name for the permission set (e.g., "Integration Service Account Permissions").
4. Assign Permissions
   In the Permissions section, assign only the permissions needed for the service account to function. Typical permissions might include:
   1. Can add event
   2. Can add event category
   3. Can add event type
   4. Can add message
   5. Can add observation
   6. Can add source
   7. Can add source provider
   8. Can add subject
   9. Can change event
   10. Can change event category
   11. Can change event type
   12. Can change message
   13. Can change observation
   14. Can change source
   15. Can change source provider
   16. Can change subject
   17. Can view event
   18. Can view event category
   19. Can view event type
   20. Can view message
   21. Can view observation
   22. Can view source
   23. Can view source provider
   24. Can view subject
5. Save the Permission Set
   1. Click Save to finalize the configuration.

1. Accéder à la page des ensembles d'autorisations
   1. Connectez-vous à la page d'administration d'Earthranger.
   2. Accédez à Comptes utilisateurs > Ensembles d'autorisations.
2. Vérifiez la présence d'un ensemble d'autorisations
   1. Recherchez un ensemble d'autorisations adapté aux besoins de l'intégration ou de l'application.
   2. Si un ensemble d'autorisations approprié existe, passez à l'étape suivante.
3. Ajouter un nouvel ensemble d'autorisations (si nécessaire)
   1. Cliquez sur « Ajouter un ensemble d'autorisations » en haut à droite.
   2. Saisissez un nom descriptif pour l'ensemble d'autorisations (par exemple, « Autorisations du compte de service d'intégration »).
4. Attribuer des autorisations
   Dans la section « Autorisations », attribuez uniquement les autorisations nécessaires au fonctionnement du compte de service. Les autorisations typiques peuvent inclure :
   1. Ajouter un événement
   2. Ajouter une catégorie d’événement
   3. Ajouter un type d’événement
   4. Ajouter un message
   5. Ajouter une observation
   6. Ajouter une source
   7. Ajouter un fournisseur de source
   8. Ajouter un objet
   9. Modifier l’événement
   10. Modifier la catégorie d’événement
   11. Modifier le type d’événement
   12. Modifier le message
   13. Modifier l’observation
   14. Modifier la source
   15. Modifier le fournisseur de source
   16. Modifier l’objet
   17. Afficher l’événement
   18. Afficher la catégorie d’événement
   19. Afficher le type d’événement
   20. Afficher le message
   21. Afficher l’observation
   22. Afficher la source
   23. Afficher le fournisseur de source
   24. Afficher l’objet
5. Enregistrer l’ensemble d’autorisations
   1. Cliquez sur Enregistrer pour finaliser la configuration.

Étape 2 : Créer un compte de service

Une fois qu’un ensemble d’autorisations est prêt, créez le compte de service et attribuez les autorisations appropriées.

1. Access the Users Page
   1. Navigate to User Accounts > Users in the Site Admin page.
2. Check for an Existing Service Account
   1. Search for an existing service account related to the application or integration.
   2. If the account exists, verify its configuration and permissions.
3. Add a New Service Account (If Necessary)
   1. Click Add User in the top-right corner.
   2. Complete the following fields:
      1. First Name: Enter a descriptive name (e.g., "Integration").
      2. Last Name: Specify the type of account (e.g., "Service Account").
      3. Username: Create a unique identifier (e.g., integration_serviceaccount).
      4. Permission Sets: Assign the previously created permission set.
      5. Active: Check this box to enable the account.
4. Save the Account
5. Click Save to create the account.

1. Accéder à la page Utilisateurs
   1. Accédez à « Comptes utilisateurs » > « Utilisateurs » dans la page d'administration du site.
2. Rechercher un compte de service existant
   1. Recherchez un compte de service associé à l'application ou à l'intégration.
   2. Si le compte existe, vérifiez sa configuration et ses autorisations.
3. Ajouter un nouveau compte de service (si nécessaire)
   1. Cliquez sur « Ajouter un utilisateur » en haut à droite.
   2. Renseignez les champs suivants :
      1. Prénom : Saisissez un nom descriptif (par exemple, « Intégration »).
      2. Nom : Spécifiez le type de compte (par exemple, « Compte de service »).
      3. Nom d'utilisateur : Créez un identifiant unique (par exemple, « intégration_serviceaccount »).
      4. Ensembles d'autorisations : Attribuez l'ensemble d'autorisations précédemment créé.
      5. Actif : Cochez cette case pour activer le compte.
4. Enregistrer le compte
5. Cliquez sur « Enregistrer » pour créer le compte.

Pour plus d'informations sur la gestion des utilisateurs dans EarthRanger Admin, reportez-vous à Gestion des utilisateurs dans EarthRanger Admin..